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.

Category
Lists & combo boxes
Unit
uMlSkinBoxCtrls.pas
Inherits from
TMlSkinCustomGroupBoxTMlSkinCustomControl

Notes

  • FrameStyle picks the look: fsLine draws just a caption line, fsBox a full frame.
  • CaptionHeight sets the caption height, CaptionAlignment its alignment, and CaptionLight can add a glow.
  • Turning on CheckBox puts a check box before the caption, typically used to enable or disable everything in the group.
  • The divider line can fade from LineStartColor to LineStopColor.

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

NameTypeDefaultDescription
CaptionAlignmentTAlignmenttaLeftJustifyAlignment of the caption.
CaptionLightTMlLightClassGlow effect for the caption.
CaptionstringThe text shown on the control.
CaptionHeightInteger15Height of the caption area in pixels.
CheckBoxTGroupBoxCheckBoxThe check box in front of the caption; it is typically used to enable or disable everything in the group.
LineStartColorTColor$00CFA753Starting colour of the divider line.
LineStopColorTColor$00FEFBF6Ending colour of the divider line, giving a gradient with the start colour.
LightBooleanFalseGlow effect: switch, glow color and blur radius.
FrameStyleTGroupBoxFrameStylefsLineFrame style: fsLine draws only the caption line, fsBox a full box.
Properties of TMlSkinCustomControl 5
NameTypeDefaultDescription
AboutTMlAboutInfoA 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.
TransparentBooleanTrueTransparent background: the control skips its own fill and shows the form background (image or color) instead.
ColorTColorclWhiteBackground color of the control; ignored while Transparent is on.
AutoInvalidateBooleanFalseRepaints automatically when the content changes. Turn it on if property changes do not show up.
EraseBackgroundBooleanFalseWhether the background is erased before painting; worth toggling if the control flickers.
Events of TMlSkinCustomControl 4
NameTypeDefaultDescription
OnDPIChangedTMlDPIChangedEventFires 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.
OnBackgroundChangingTMlBackgroundEventFires just before the background changes, giving you a chance to adjust what is drawn.
OnBackgroundChangedTMlCustomDrawEventFires after the background has been drawn, so you can paint on top of it.
OnVisibleChangedTNotifyEventFires 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.