Table of the WidgetsThe Model Button Widget
 

The Button Widget

A View of a Button Widget

View Class: Button
Spec Class: ActionButtonSpec

The Button Widget is used to provide simple pushing actions.
 
 


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".
Label Label of the button.  
If the "Label Is Image" check box is turned off, the value here is the label string.
Otherwise, the value is the name of the selector, which returns the label
- either a string or a bitmap from the application.
A labelChannel may overwrite this (see below).
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 is passed as a string.
Argument Argument passed with the action selector.  
The selector must end with ':'.
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 may 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 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.
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"
 


[stx-logo]
Copyright © 1998 eXept Software AG, all rights reserved