TMlSkinGroupBox
A group box that frames related controls with a line or a full box, optionally with a check box in the caption to enable the whole group.
Notes
FrameStylepicks the look:fsLinedraws just a caption line,fsBoxa full frame.CaptionHeightsets the caption height,CaptionAlignmentits alignment, andCaptionLightcan add a glow.- Turning on
CheckBoxputs a check box before the caption, typically used to enable or disable everything in the group. - The divider line can fade from
LineStartColortoLineStopColor.
Example
From the demo MlSkin.MainDemo.v3.0 (.dfm form file)
object mlskngrpbx2: TMlSkinGroupBox
Left = 862
Top = 26
Width = 185
Height = 114
Caption = 'GroupBox2'
CheckBox.Pictures = 'MlSkinCheckBox'
...
Properties 9
| Name | Type | Default | Description |
|---|---|---|---|
CaptionAlignment | TAlignment | taLeftJustify | Alignment of the caption. |
CaptionLight | TMlLightClass | — | Glow effect for the caption. |
Caption | string | — | The text shown on the control. |
CaptionHeight | Integer | 15 | Height of the caption area in pixels. |
CheckBox | TGroupBoxCheckBox | — | The check box in front of the caption; it is typically used to enable or disable everything in the group. |
LineStartColor | TColor | $00CFA753 | Starting colour of the divider line. |
LineStopColor | TColor | $00FEFBF6 | Ending colour of the divider line, giving a gradient with the start colour. |
Light | Boolean | False | Glow effect: switch, glow color and blur radius. |
FrameStyle | TGroupBoxFrameStyle | fsLine | Frame style: fsLine draws only the caption line, fsBox a full box. |
Properties of TMlSkinCustomControl 5
| Name | Type | Default | Description |
|---|---|---|---|
About | TMlAboutInfo | — | A design-time property: double-clicking it in the Object Inspector opens the MLSkin about box with the component version. It has no effect at run time and is not stored in the .dfm. |
Transparent | Boolean | True | Transparent background: the control skips its own fill and shows the form background (image or color) instead. |
Color | TColor | clWhite | Background color of the control; ignored while Transparent is on. |
AutoInvalidate | Boolean | False | Repaints automatically when the content changes. Turn it on if property changes do not show up. |
EraseBackground | Boolean | False | Whether the background is erased before painting; worth toggling if the control flickers. |
Events of TMlSkinCustomControl 4
| Name | Type | Default | Description |
|---|---|---|---|
OnDPIChanged | TMlDPIChangedEvent | — | Fires when the screen DPI changes, for example when the window moves to a monitor with a different scaling — a good place to re-adjust anything you draw yourself. |
OnBackgroundChanging | TMlBackgroundEvent | — | Fires just before the background changes, giving you a chance to adjust what is drawn. |
OnBackgroundChanged | TMlCustomDrawEvent | — | Fires after the background has been drawn, so you can paint on top of it. |
OnVisibleChanged | TNotifyEvent | — | Fires when the control is shown or hidden. |
Only the properties and events MLSkin adds are listed here. Standard VCL properties such as Align, Anchors, Font and OnClick are available too and behave exactly as on the stock controls.
Offline helpA PDF / CHM version is available for offline reading.