TLabel

ready for revision

TLabel shows some Text on the form.

Alternatives

• You can use TDispWidget successor like TStringDisp
• If you want display text next to a widget, you can use TFrame.Caption of this component.

Reference

Hierarchy

• TObject
• TPersistent
• TComponent
• TMseComponent
• TActComponent
• TWidget
• TActionWidget
• TActionPublishedWidgetNwr
• TPublishedWidgetNwr
• TPublishedWidget
• TCustomLabel
• TLabel

Properties

inherited from TWidget

Anchors

Bounds

Color

Cursor

Enabled

Face

Font

Frame

Hint

OptionsWidget

OptionsWidget1

PopupMenu

TabOrder

Visible

Caption

The Caption is the text the label displays.

{$ifdef mse_unicodestring}
  msestring = unicodestring;
{$else}
  msestring = widestring;
{$endif}

property caption: msestring;

Options

With the option lao_nogray you can prevent a label to be shown grayed if itself or a parent widget is disabled.

labeloptionty = (lao_nogray,lao_nounderline);
labeloptionsty = set of labeloptionty;

property Options: labeloptionsty default [];

If you use a & char in a caption, the following char gets underlined. To prevent this use lao_nounderline:

TextFlags

With TextFlags you can specify things like alignment or rotation. See the following image and the image at CaptionTextFlags

textflagty = (tf_xcentered, tf_right, tf_xjustify, tf_ycentered, tf_bottom, 
               tf_rotate90, tf_rotate180,
               tf_clipi, tf_clipo,
               tf_grayed, tf_wordbreak, tf_softhyphen,
               tf_noselect, tf_underlineselect,
               tf_ellipseleft, tf_ellipseright,
               tf_tabtospace, tf_showtabs,
               tf_force);
textflagsty = set of textflagty;

property TextFlags: textflagsty default defaultlabeltextflags;

Methods

Events

Inherited from TWidget

OnHint

OnEnter, OnFocus, OnActivate

OnNavigRequest

OnPopup

OnPaint, OnPaintBackground, OnAfterPaint, OnPaintBackground

Inherited from TMseComponent: OnBeforeUpdateSkin, OnAfterUpdateSkin

Known issues

Issues of the class

Issues of this documentation

Feel free to add your points here.

From the Free Pascal wiki, page "Reference: MSEgui/TLabel", as it stood on 2020-02-25 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's Licensing page. If you have concerns about this material, message the admin.