TMlSkinLabel

Notes

• With Transparent on it blends into the form background, so no solid block shows on a dark skin.
• Horizontal and vertical alignment are set separately through AlignmentHorizontal and AlignmentVertical.
• AutoSize resizes the control to fit the text; at a fixed size, EllipsisPosition decides how long text is truncated.
• Turn on RoundBackground and set Color for a rounded tag-style label.

Example

From the demo MlSkin.Demo.圆角标签按钮和提示框.v3.0 (.dfm form file)

object lbl1: TMlSkinLabel
  Left = 14
  Top = 15
  Width = 98
  Height = 41
  Color = 5392355
  AutoInvalidate = True
  Alpha = 255
  AlignmentHorizontal = taCenter
  AlignmentVertical = taVerticalCenter
  AutoSize = False
  RoundBackground = True
  Caption = 'UserName'
  Light.Active = False
  Font.Charset = DEFAULT_CHARSET
  Font.Color = clWhite
  Font.Height = -12
  Font.Name = 'Tahoma'
  Font.Style = [fsBold]
  ParentFont = False

Properties 10

Name	Type	Default	Description
Alpha	Byte	192	Opacity: 0 fully transparent, 255 opaque.
EllipsisPosition	TEllipsisPosition	epNone	Where the ellipsis goes when text is too long: epEndEllipsis at the end, epPathEllipsis in the middle (good for paths), epWordEllipsis at a word boundary, epNone none.
AlignmentHorizontal	TAlignment	taLeftJustify	Horizontal text alignment: left, centred or right.
AlignmentVertical	TVerticalAlignment	taAlignTop	Vertical text alignment: top, centred or bottom.
AutoSize	Boolean	True	Whether the control resizes itself to fit its content.
RoundBackground	Boolean	False	Draws the background with rounded corners; combined with Color it gives a tag-style text block.
RoundSize	Integer	5	Corner radius in pixels; 0 means square corners.
Light	TMlLightClass	—	Glow effect: switch, glow color and blur radius.
WordWap	Boolean	False	Whether long text wraps to the next line.
Color	TColor	clWhite	Background color of the control; ignored while Transparent is on.

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 4

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.
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.