The Label Widget

View Class: Label
Spec Class: LabelSpec

The Label Widget is used to provide text output capabilities. The text string cannot be edited. Usually, they are used in conjunction with Entry Field Widgets.

The Basics Section:

ID	Unique symbolic name (ID) of the label. This ID can be used by the application to access the widget via `"builder>>componentAt:#ID"`.
Label	String of the label.
Label Is Image	Turns on/off that the string of the label is taken as selector. The selector is sent to the application in order to get an `Image` instance. The method can either fetch an image from a file or contain an image resource specification which can be defined by using the Image Editor.
Translate Label	Turns on/off that the string of the label is translated by the resource file to a national language string.

The Details Section:

Font	Defines the font style of the label. After selecting the check toggle the font style can be chosen by selecting one of the Family/Face/Style/Size buttons. If no font style is selected, the label takes its default font style from the style sheet.
FG-Color	Defines the foreground color of the label. After selecting the check toggle the foreground color can be chosen by selecting the desired colored button. If no color is selected (i.e. the checkToggle is off), the label takes its default foreground color from the style sheet. Notice, that a fgChannel valueHolder may provide a different color, and overwrite this setting.
BG-Color	Defines the background color of the label. After selecting the check toggle the background color can be chosen by selecting the desired colored button. If no color is selected (i.e. the checkToggle is off), the label takes its default background color from the style sheet. Notice, that a bgChannel valueHolder may provide a different color, and overwrite this setting.
Border	Defines the width of the border.
Level	Defines the width of the 3D-border. Positive values provide a raising, negative values provide a lowering of the label.
Justification	Defines the justification of the logo/string inside the label area. Possible values are: left (show logo left-adjusted), right (show logo right-adjusted), center (show logo centered), centerEach (like center, but center each line of a multipline logo), centerLeft (like center, but show left adjusted if logo does not fit), centerRight (like center, but show right adjusted if logo does not fit), leftRight (like left, but show right adjusted if logo does not fit), rightLeft (like right, but show left adjusted if logo does not fit), The last four are useful to make certain, that the most interesting part of the label is shown, in case it does not fit. (for example: a file names right part)
Resize For Label	Turns on/off whether the label recomputes its layout, if the extent of the string has changed.
Initially Invisible	Turns on/off that the label is initially invisible.

The Channels Section:

Label Aspect selector or binding for the string of the label.
It should return a ValueModel* instance with a String instance.
It is used to provide a dynamically changing of the label.

FG-Color

Aspect selector or binding controlling the foreground color of the label.
If left blank, the fgColor is defined by the above static color setting or the styleSheet.
if specified, the binding should return a

    - Color instance (static behavior)
    - Block evaluating to a Color (halfway static behavior).
    - ValueModel* instance with a Color instance.

A value model can be used to provide a dynamically changing of the foreground color.
A block will be evaluated once, at build time.

BG-Color

Aspect selector or binding controlling the background color of the label.
If left blank, the bgColor is defined by the above static color setting or the styleSheet.
if specified, the binding should return a

    - Color instance (static behavior)
    - Block evaluating to a Color (halfway static behavior).
    - ValueModel* instance with a Color instance.

A value model can be used to provide a dynamically changing of the foreground color.
A block will be evaluated once, at build time.

* = ValueHolder, AspectAdaptor, BufferedValueHolder, RangeAdaptor, TriggerValue

The Help Section:

see document "Using the Help Tool"

The Layout Section:

see document "The Layout of the Widgets"