TMlSkinGroupBox

用法要点

• FrameStyle 选择外观：fsLine 只画一条标题线，fsBox 画完整的方框。
• 标题栏高度用 CaptionHeight，对齐用 CaptionAlignment，还能用 CaptionLight 给标题加发光。
• CheckBox 打开后标题前出现勾选框，可用来整体启用或禁用组内控件。
• 分隔线支持渐变：LineStartColor 到 LineStopColor。

示例

摘自 Demo：MlSkin.MainDemo.v3.0（窗体文件 .dfm）

object mlskngrpbx2: TMlSkinGroupBox
  Left = 862
  Top = 26
  Width = 185
  Height = 114
  Caption = 'GroupBox2'
  CheckBox.Pictures = 'MlSkinCheckBox'
  ...

属性 9

名称	类型	默认值	说明
CaptionAlignment	TAlignment	taLeftJustify	标题文字的对齐方式。
CaptionLight	TMlLightClass	—	标题文字的发光效果。
Caption	string	—	控件上显示的文字。
CaptionHeight	Integer	15	标题栏的高度（像素）。
CheckBox	TGroupBoxCheckBox	—	标题前的勾选框设置。打开后可以用它整体启用或禁用组内的控件。
LineStartColor	TColor	$00CFA753	分隔线的起始颜色。
LineStopColor	TColor	$00FEFBF6	分隔线的结束颜色，与起始颜色形成渐变。
Light	Boolean	False	发光效果：可设开关、发光颜色和模糊半径。
FrameStyle	TGroupBoxFrameStyle	fsLine	外框样式：fsLine 只画标题线，fsBox 画完整方框。

TMlSkinCustomControl 的属性 5

名称	类型	默认值	说明
About	TMlAboutInfo	—	设计期属性。在对象检查器里双击会弹出 MlSkin 的关于窗口，显示组件版本信息；运行时没有作用，也不会保存到 dfm。
Transparent	Boolean	True	背景是否透明。打开后控件不画自己的底色，直接显示窗体的背景（图片或颜色）。
Color	TColor	clWhite	控件的底色。Transparent 打开时不生效。
AutoInvalidate	Boolean	False	内容变化时是否自动重绘。动态改属性看不到变化时可以打开。
EraseBackground	Boolean	False	绘制前是否擦除背景。界面闪烁时可以调整这个开关。

TMlSkinCustomControl 的事件 4

名称	类型	默认值	说明
OnDPIChanged	TMlDPIChangedEvent	—	屏幕 DPI 改变时触发（例如窗口被拖到另一块不同缩放的显示器上），可在这里重新调整自绘内容。
OnBackgroundChanging	TMlBackgroundEvent	—	背景即将改变时触发，可在这里干预要绘制的背景。
OnBackgroundChanged	TMlCustomDrawEvent	—	背景绘制完成后触发，可在背景之上继续自绘内容。
OnVisibleChanged	TNotifyEvent	—	控件显示或隐藏时触发。

本页只列出 MlSkin 新增的属性和事件；Align、Anchors、Font、OnClick 等标准 VCL 属性同样可用，用法与原生控件一致。