The Push Button Options dialog can be displayed by clicking on the Options... push button in the Edit Push Button dialog. This dialog presents additional attributes of a push button form field, primarily related to dynamic behavior. The dialog consists of two sections: behavior and callback events.
This section presents behavioral attributes of a push button form field.
| Auto Skip | This field determines if the focus automatically skips to the next field in the tab order when the push button is selected. |
| Validate Focus Field | This field determines if the push button causes the field which currently has the input focus to be validated prior to the push button gaining the input focus. |
This section presents the different callback events to which the push button can be made to respond.
| Got Focus | If this field is selected, the push button responds to a "Got Focus" event and terminates a FORM INPUT command. A "GotFocus" event occurs when the push button receives the input focus, by a mouse click, tabbing or an accelerator key. After the FORM INPUT command terminates, the event vector Event is populated as follows: Event.EventName contains the string "GotFocus", Event.EventType contains the string "FormField", and Event.EventTag contains the Field Tag value associated with the push button or if blank, the push button's Field Name. |
| Lost Focus (Always) | If this field is selected, the push button responds to a "Lost Focus (Always)" event and terminates a FORM INPUT command. A "Lost Focus (Always)" event occurs when the push button loses the input focus, by mouse click, tabbing or an accelerator key. After the FORM INPUT command terminates, the event vector Event is populated as follows: Event.EventName contains the string "LostFocus", Event.EventType contains the string "FormField", and Event.EventTag contains the Field Tag value associated with the push button or if blank, the push button's Field Name. |
| Click | If this field is selected, the push button responds to a "Click" event and terminates a FORM INPUT command. A "Click" event occurs when the push button receives the input focus by mouse click. After the FORM INPUT command terminates, the event vector Event is populated as follows: Event.EventName contains the string "Click", Event.EventType contains the string "FormField", and Event.EventTag contains the Field Tag value associated with the push button or if blank, the push button's Field Name. |
| Close | This push button performs any required data validation, records (but does not commit) any changes which were made in this dialog, and returns to the Edit Push Button dialog. |
| Cancel | This push button discards any changes that were made in this dialog and returns to the Edit Push Button dialog. |
| Help | This push button invokes the Zim Help facility, initially displaying the section entitled Push Button Options dialog (this section). |