BUTTON item type

The BUTTON item type defines a push-button that can trigger an action.

Rendering


BUTTON item type screenshot

Figure 1. BUTTON item type

Syntax

BUTTON item-tag: item-name [  , attribute-list ] ;
  1. item-tag is an identifier that defines the name of the item tag in the layout section.
  2. item-name defines the form item name and the action name.
  3. attribute-list defines the aspect and behavior of the form item.

Attributes

COMMENT, FONTPITCH , HIDDEN , IMAGE, SAMPLE , SIZEPOLICY , STYLE , TABINDEX , TAG, TEXT.

Usage

The BUTTON form item type defines a standard push button with a label or a picture.

The label of a BUTTON form item is defined with the TEXT attribute. The picture is defined by the IMAGE attribute. The COMMENT attribute can be used to define a help bubble for the button.

The action name is defined by the item-name. It can be prefixed with a sub-dialog identifier and/or a field name, to define a qualified action view. See the action handler binding rules for more details.

When controlled by a COMMAND action handler in a DIALOG interactive instruction, form buttons can get the focus and thus be part of the tabbing list (TABINDEX attribute).

BUTTON btn1: print, TEXT="Print Report", IMAGE="printer";