The Entry Field Options dialog can be displayed by clicking on the Options push button in the Edit Entry Field dialog. This dialog presents additional attributes of an entry field, primarily related to dynamic behavior. The dialog consists of two sections: behavior and callback events.
This section presents behavioral attributes of an entry field.
| Auto Select | This check box determines if the data contents of an entry field are be automatically highlighted when the field receives the focus. |
| Auto Skip | This check box determines if the focus automatically skips to the next field in the tab order when this field is completely filled. |
| Case | This list box determines the case of data displayed in alphanumeric entry fields. The available values are "Mixed', "Upper" and "Lower". "Mixed" means preserve the case of the assigned data. "Upper" means force all alphabetic characters to upper case. "Lower" means force all alphabetic characters to lower case. |
| Justification | This list box determines the justification of data displayed in entry fields. The available values are "None", "Center", "Left", "Right" and "Wrap". "Left" means that the data is displayed flushed left within the physical width of the field. "Center" means that the data is displayed centered within the physical width of the field. "Right" means that the data is displayed flushed right within the physical width of the field. In Zim for Windows, "None" is identical to "Left" and, as data wrapping in entry fields is always in effect, "Wrap" is also identical to "Left". |
This section presents the different callback events which the entry field can be made to respond to.
| Got Focus | If this check box is selected, the entry field responds to a "GotFocus" event and terminates a FORM INPUT command. A "GotFocus" event occurs when the entry field receives the input focus, whether 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 check box is selected, the entry field responds to a "LostFocus (Always)" event and terminates a FORM INPUT command. A "Lost Focus (Always)" event occurs when the entry field loses the input focus, whether 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 check box is selected, the entry field responds to a "LostFocus (Modified)" event and terminates a FORM INPUT command. A "Lost Focus (Modified)" event occurs when the entry field's data value is modified and the field then looses the input focus, whether 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 entry field responds to a "Click" event and terminates a FORM INPUT command. A "Click" event occurs when the entry field receives the input focus by mouse click and data selection is not being performed. 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 check box is selected, the entry field 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 entry field. 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 check box is selected, the entry field responds to a "Modified" event and terminates a FORM INPUT command. A "Modified" event occurs when the entry field's data value is modified in any way. 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 Entry Field dialog. |
| Cancel | This push button discards any changes that were made in this dialog and returns to the Edit Entry Field dialog. |
| Help | This push button invokes the Zim Help facility, initially displaying the section entitled Entry Field Options dialog (this section). |