The List Box Options dialog can be displayed by clicking on the Options push button in the Edit List Box dialog. This dialog presents additional attributes of a list box, primarily related to dynamic behavior. The dialog consists of two sections: behavior and callback events.
Behavior Section
This section presents behavioral attributes of a list box form field object.
| Auto Skip | This check box determines if the focus automatically skips to the next field in the tab order when this field is selected. |
This section presents the different callback events to which the list box can be made to respond.
| Lost Focus | If this field is selected, the list box responds to a "GotFocus" event and terminates a FORM INPUT command. A "GotFocus" event occurs when the list box 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 entry field or if blank, the entry field's Field Name. |
| Lost Focus (Always) | If this field is selected, the list box responds to a "LostFocus (Always)" event and terminates a FORM INPUT command. A "Lost Focus (Always)" event occurs when the list box 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 entry field or if blank, the entry field's Field Name. |
| Lost Focus (Modified) | If this field is selected, the list box responds to a "LostFocus (Modified)" event and terminates a FORM INPUT command. A "LostFocusModified" event occurs when a list member other than the currently highlighted list member is selected and the list box 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 field is selected, the list box responds to a "Click" event and terminates a FORM INPUT command. A "Click" event occurs when the list box 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 entry field or if blank, the entry field's Field Name. |
| Double Click | If this field is selected, the list box responds to a "Double Click" event and terminates a FORM INPUT command. A "Double Click" event occurs when a double click of the mouse occurs within the list box. After the FORM INPUT command terminates, the event vector Event is populated as follows: Event.EventName contains the string "DoubleClick", 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. |
| Modified | If this field is selected, the list box responds to a "Modified" event and terminates a FORM INPUT command. A "Modified" event occurs when a list member other than the currently highlighted list member is selected. 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 that were made in this dialog, and returns to the Edit List Box dialog. |
| Cancel | This push button discards any changes that were made in this dialog and returns to the Edit List Box dialog. |
| Help | This push button invokes the Zim Help facility, initially displaying the section entitled List Box Options dialog (this section). |