The Model Button Widget

View Class: Button
Spec Class: ButtonSpec

The Model Button Widget has the same behavior like the Button Widget exept that it does not work on a callback action but on a model. The model is defined as a ValueHolder instance getting the string of the entry field Value when the button is pressed.

The Basics Section:

ID	Unique symbolic name (ID) of the button. See commonAttributes
Label	Label of the button. If the check box Label Is Image is turned off, this is the label string. Otherwise, it is the name of the selector, which returns the label - either a string or a bitmap from the application.
Model	Aspect selector or binding for the value defined in the entry field Value. It should return a `ValueModel`* instance.
Value	Defines the string which is set in the `ValueModel` instance above when the button is pressed.
Be Default	Turns on/off displaying of a return key after the label string.
Size As Default	Turns on/off that the button computes its size including space for the default (return) image. Useful for buttons which are initially not default buttons, but become a default button dynamically.
Label Is Image	Turns on/off that the name of the label is taken as selector. The selector should return a string or bitmap image used as logo in the button.
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 define 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.
Initially Invisible	Turns on/off that the button is initially invisible.
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.

The Channels Section:

Enable	Aspect selector or binding for en-/disabling the button. It should return a - `Boolean` instance** (only for static behavior) - `ValueModel`* instance with a `Boolean` instance** 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 with a `String` instance. It is used to provide a dynamically changing of the label.
FG-Color	Aspect selector or binding for the foreground color of the button. It should return a - `Color` instance (only for static behavior) - `ValueModel`* instance with a `Color` instance. A value model is used to provide a dynamically changing of the foreground color.
BG-Color	Aspect selector or binding for the background color of the button. It should return a - `Color` instance (only for static behavior) - `ValueModel`* instance with a `Color` instance. A value model is used to provide a dynamically changing of the 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"