The Button and LinkButton Widgets

View Class: Button
Spec Class: ActionButtonSpec

The Button Widget is used to provide simple push actions.
LinkButtons have the same behavior, but display themself like a web-Browsers link (i.e. without 3D effect).

The Basics Section:

ID	Unique symbolic name (ID) of the button. This ID can be used by the application to access the widget via `"builder componentAt:#ID"`.
Text	Label of the button. If the "Label Is Image" check box is turned off, the fields value is the label string. Otherwise, the fields value is the name of the selector, which returns the actual label - either a string or a bitmap from the application. A labelChannel may overwrite this (see below).
Disabled Label	Label of the button shown when disabled. Like the above. Allows for the button to change its label or bitmap image depending on its enable-state.
Action	Name of the selector which is sent to the application when the button is pressed. If the selector is an one-arg selector, the argument (below) is passed as a string.
Argument1	An optional argument passed with the action selector (above). The selector must be a 1-arg selector; i.e. it must end with a colon (':').
Argument2	Another optional argument passed with the action selector (above). The selector must be a 2-arg selector.
Be Default	If on, a default ("return bitmap image") is shown in the button after the label string. Typically, this is used to indicate a default button in a dialog (i.e. the one which fires its action, when the return key is pressed).
Size As Default	If on, the button computes its (preferred) size as if it was a default ("return") button Useful for buttons which are initially not default buttons, but may become a default button dynamically.
Label Is Image	Turns on/off that the name of the label is taken as selector. The method should return a string, text or bitmap image which will be used as the buttons logo.
Translate Label	Turns on/off that the label string is translated via the resource mechanism to a national language string. A translation for that string must be defined in the resource file of the application class.

The Details Section:

Font	Defines the font style of the button's 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 button takes its default font style from the style sheet.
FG-Color	Defines the foreground color of the button, i.e. the color of the letters. After selecting the check toggle the foreground color can be chosen by selecting the desired colored button. If no color is selected, the button takes its default foreground color from the style sheet.
BG-Color	Defines the background color of the button, i.e. the color of the button's view. After selecting the check toggle the background color can be chosen by selecting the desired colored button. If no color is selected, the button takes its default background color from the style sheet.
Initially Disabled	Turns on/off that the button is initially disabled. An enableChannel may overwrite this (see below).
Initially Invisible	Turns on/off that the button is initially invisible. A visibilityChannel may overwrite this (see below).
Can Tab	Turns on/off that the button can be reached by tabbing.
Auto Repeat	Turns on/off that the action is evaluated repeatedly as long as the button is pressed. To get this behavior, the check box Triggered On Down must be turned on.
Trigger On Down	Turns on/off that the action is evaluated when the button is pressed; otherwise, when released.
Resize For Label	Turns on/off that the button dynamically resizes itself whenever its logo changes.

The Channels Section:

Visible	Aspect selector or binding for making the button visible/invisible. It should return one of: - `Boolean` instance** (only for static behavior) - `Block` evaluating to a `Boolean` (evaluated once, at creation time of the widget) - `ValueModel`* instance providing a `Boolean`** A value model is used to make this feature dynamically changable.
Enable	Aspect selector or binding for en-/disabling the button. It should return one of: - `Boolean` instance** (only for static behavior) - `Block` evaluating to a `Boolean` - `ValueModel`* instance providing a `Boolean`** A value model is used to provide a dynamically changing of the ability of the button.
Label	Aspect selector or binding for the label of the button. It should return a `ValueModel`* instance providing a `String`. Can be used to dynamically change the label of the widget.
FG-Color	Aspect selector or binding for the foreground color of the button. It should return one of: - `Color` instance (only for static behavior) - `Block` evaluating to a `Color` - `ValueModel`* instance providing a `Color`. A value model is used to dynamically change the widgets foreground color.
BG-Color	Aspect selector or binding for the background color of the button. It should return one of: - `Color` instance (only for static behavior) - `Block` evaluating to a `Color` - `ValueModel`* instance with a `Color` instance. A value model is used to dynamically change the widgets background color.

* = ValueHolder, AspectAdaptor, BufferedValueHolder, RangeAdaptor, TriggerValue
** = true, false

The Help Section:

see document "Using the Help Tool"

The Layout Section:

see document "The Layout of the Widgets"