.section Widgets
.topic widget.label
.title Label
.toc 0 Label
.index Label
.index wgtLabel
.index wgtLabelSetAlign

.h2 Label

A static text label. Does not accept keyboard focus. Typically used to describe other widgets. Supports text alignment and accelerator keys (with WCLASS_FOCUS_FORWARD, the accelerator moves focus to the next focusable sibling).

Header: widgets/widgetLabel.h

.h3 Creation

.code
WidgetT *lbl = wgtLabel(parent, "Name:");
.endcode

.h3 Macros

.table
  Macro                        Description
  -----                        -----------
  wgtLabel(parent, text)       Create a text label.
  wgtLabelSetAlign(w, align)   Set the text alignment (AlignStartE, AlignCenterE, AlignEndE).
.endtable

.h3 Properties

Use wgtSetText() / wgtGetText() to change the text. Set accelKey for accelerator support (focus forwards to next focusable widget).

.h3 Events

Labels use the common events only. Typically no callbacks are set on labels.

.h3 Properties (BASIC Interface)

.table
  Property     Type                         Access       Description
  --------     ----                         ------       -----------
  Alignment    Enum (Left, Center, Right)   Read/Write   Text alignment within the label.
.endtable

.hr