Button Gadgets

Software Customisation Guide

Gadget Set : Button Gadgets

When the user presses a button gadget (control button) it will usually display a child form or invoke a call-back - typically a PML Form method.

Buttons have a tag-name or pixmap which is shown within the button rectangle. The tag, pixmap, call-back, and child form are all optional.

(See Gadgets that Support Pixmaps for more about pixmaps).

For example:

button .SubForm 'More . . .' FORM !!ChildForm

button .SubForm pixmap /filename FORM !!ChildForm

button .Calculate 'Calculate' CALLBACK
‘!this.CallbackFunction()’

The user can specify the width of the BUTTON independently of any tag text string it contains using the WIDTH syntax. The user can also define its height with the HEIGHT syntax, allowing the user to define textual BUTTONs taller than a single character in height.

For example:

Button .btn1 |reject selection| at ... width 10 height 1.5

Note:

The BUTTON‘s tag is always centre-aligned within the define area.