TMlSkinGroupControls
A grouped option control that lays a set of choices out in columns, with one selected at a time — a graphical radio group.
Notes
- The captions go into
Itemsand the current choice is read and written throughItemIndex. Columnssets how many columns are used, whileItemHeightandVerticalSpacingcontrol the height and spacing of each row.- Use
OnDrawItemto draw the entries yourself.
Properties 24
| 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. |
Columns | Integer | 1 | How many columns the entries are laid out in. |
ItemIndex | Integer | -1 | Index of the selected entry, starting at 0; -1 means nothing is selected. |
Items | TStrings | — | The list of entry captions, one per line. |
ItemHeight | Integer | 17 | Height of each entry in pixels. |
Kind | TGroupControlKind | gckRadio | The control's kind or orientation. |
Offset | TMlOffset | — | Overall offset (X, Y) of the content. |
VerticalSpacing | Integer | 3 | Vertical gap between rows in pixels. |
Pictures | TMlResID | — | The images used by the control, split into frames per state: unchecked, checked, hot, disabled. |
Alpha | Byte | 192 | Opacity: 0 fully transparent, 255 opaque. |
BorderAlpha | Byte | 255 | Border opacity from 0 (invisible) to 255 (solid). |
BorderSides | TSides | — | Which border edges are drawn — any combination of top, bottom, left and right. |
BorderColor | TColor | $00D9CBBA | Border color. |
Color | TColor | clWhite | Background color of the control; ignored while Transparent is on. |
BackgroundFillType | TMlPngFillType | ftNormal | How the background image is laid out: ftNormal as-is, ftTile tiled, ftAutoStretch auto-stretched, ftCenter centred, ftStretch stretched to fill, ftGradient gradient. |
BackgroundImage | TMlResID | — | Background image, given as a resource ID or an image file path. |
BackgroundOffsetX | Integer | 0 | Horizontal offset of the background image in pixels. |
BackgroundOffsetY | Integer | 0 | Vertical offset of the background image in pixels. |
GradientDirection | TGradientDirection | gdVertical | Gradient direction: gdHorizontal or gdVertical. |
GradientAlign | TGradientAlign | gaCenter | Where the gradient is anchored: centre, left or right. |
GradientSize | Integer | 60 | Size of the gradient band in pixels. |
GradientStartColor | TColor | $00FFC446 | Starting color of the gradient. |
GradientEndColor | TColor | $00FDF8F3 | Ending color of the gradient. |
DoubleBorder | Boolean | True | Double border: draws a second line inside the border. |
Events 2
| Name | Type | Default | Description |
|---|---|---|---|
OnChanged | TNotifyEvent | — | Fires after the state or value has changed. |
OnDrawItem | TMlGCItemDrawEnvent | — | Fires while an entry is drawn, so you can style it yourself. |
Events of TMlSkinCustomPanel 1
| Name | Type | Default | Description |
|---|---|---|---|
OnCustomDraw | TMlCustomDrawEvent | — | Custom draw event: paint your own content after the control has drawn itself. |
Properties of TMlSkinCustomControl 3
| Name | Type | Default | Description |
|---|---|---|---|
Transparent | Boolean | True | Transparent background: the control skips its own fill and shows the form background (image or color) instead. |
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.