Reference: MSEgui/TLabel

From Lazarus wiki
Jump to navigationJump to search

TLabel

ready for revision

TLabel shows some Text on the form.

msegui TLabel.png

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:

msegui label options.png


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;

msegui label textflags.png

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.