TMlSkinNCMessage

A scrolling message strip on the title bar, used for announcements or status text.

Category
Title-bar controls
Unit
uMlSkinNCMessage.pas
Inherits from
TCustomMlSkinNCMessageTMlSkinNCCtrlBase

Notes

  • Text is the message, ActiveScroll starts scrolling, and Speed with Step set how fast and how far it moves.
  • LoopMode repeats the scroll; AllowClick makes it clickable and fires OnClick, for example to open the full announcement.

Properties 10

NameTypeDefaultDescription
ActiveScrollBooleanTrueWhether the text scrolls. Turn it off for static text.
AllowClickBooleanFalseWhether the strip is clickable; when on, clicking the text fires OnClick.
TextstringThe text to scroll.
FontTFontText font.
HotFontTFontFont used while the mouse is over the text, usually paired with AllowClick to show it is clickable.
LoopModeBooleanTrueWhether scrolling repeats. With it off the text scrolls once and stops.
SpeedCardinal100Scroll speed: the interval between steps, so smaller values scroll faster.
StepByte2How many pixels the text moves each step; larger values look jumpier.
WidthIntegerWidth of the message strip in pixels.
CursorTCursorcrHandPointMouse cursor shape; usually a hand when the strip is clickable.

Events 1

NameTypeDefaultDescription
OnClickTNotifyEventFires when the control is clicked.
Properties of TMlSkinNCCtrlBase 6
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.
PutSideTSideKindskdTopWhich edge of the non-client area the control sits on: skdTop, skdBottom, skdLeft or skdRight.
TagInteger0A spare integer for your own bookkeeping; the component itself does not use it.
PosTNCCtrlPosPosition along that edge: an alignment plus X/Y offsets. With UseDefault on, the default layout is used.
HintstringTooltip text shown when the mouse rests on the control.
VisibleBooleanTrueWhether the control is visible.
Events of TMlSkinNCCtrlBase 5
NameTypeDefaultDescription
OnLMouseDownTNotifyEventFires when the left mouse button goes down on the control.
OnLMouseUpTNotifyEventFires when the left mouse button is released on the control.
OnMouseEnterTNotifyEventFires when the mouse enters the control.
OnMouseLeaveTNotifyEventFires when the mouse leaves the control.
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.

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.