The Toggle Button Options dialog can be displayed by clicking on the Options check box in the Edit Toggle Button dialog. This dialog presents additional attributes of a toggle 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 toggle button form field.
| Auto Select | This check box determines if the toggle button is automatically set to the On state when the button receives the focus by through use of the tab or accelerator keys. |
| Auto Skip | This check box determines if the focus automatically skips to the next field in the tab order when the toggle button is selected. |
This section presents the different callback events to which the toggle button can be made to respond.
| Lost Focus | If this check box is selected, the toggle button responds to a "GotFocus" event and terminates a FORM INPUT command. A "GotFocus" event occurs when the toggle button receives 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 "GotFocus", Event.EventType contains the string "FormField", and Event.EventTag contains the Field Tag value associated with the toggle button or if blank, the toggle button's Field Name. |
| Lost Focus (Always) | If this check box is selected, the toggle button responds to a "LostFocus (Always)" event and terminates a FORM INPUT command. A "Lost Focus (Always)" event occurs when the toggle 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 toggle button or if blank, the toggle button's Field Name. |
| Lost Focus (Modified) | If this check box is selected, the toggle button responds to a "LostFocus (Modified)" event and terminates a FORM INPUT command. A "Lost Focus (Modified)" event occurs when the toggle button's state changes and the field then 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 "LostFocusModified", Event.EventType contains the string "FormField", and Event.EventTag contains the Field Tag value associated with the entry field or if blank, the entry field's Field Name. |
| Click | If this check box is selected, the toggle button responds to a "Click" event and terminates a FORM INPUT command. A "Click" event occurs when the toggle 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 toggle button or if blank, the toggle button's Field Name. |
| Modified | If this check box is selected, the toggle button responds to a "Modified" event and terminates a FORM INPUT command. A "Modified" event occurs when the toggle button's state changes. After the FORM INPUT command terminates, the event vector Event is populated as follows: Event.EventName contains the string "Modified", Event.EventType contains the string "FormField", and Event.EventTag contains the Field Tag value associated with the entry field or if blank, the entry field'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 Toggle Button dialog. |
| Cancel | This push button discards any changes which were made in this dialog and returns to the Edit Toggle Button dialog. |
| Help | This push button invokes the Zim Help facility, initially displaying the section entitled Toggle Button Options dialog (this section). |