The Edit Form dialog is presented only if the Screen Painter has been invoked in order to define a Zim display object (e.g. DISPLAY DEFINE <Display-Name>). The dialog is displayed by either double clicking anywhere within a form object or selecting the form object and clicking on the "attribute edit" icon in the tool bar. This dialog presents the current attributes of the selected form. The dialog consists of two sections: identification and instances.
This section displays naming and other identifying information for the form object.
| Form Name | This field contains the name of the form. The name can be changed as long as the new name together with the directory name is not the same as that for any display, menu or window object that is being defined within the same screen painting session. If the name is changed such that the form and directory names are the same as that of a form object whose definition already exists in the Data Dictionary, a warning dialog is presented which informs you that saving the definition of the form replaces the existing definition. |
| Directory | This field contains the Zim directory name for the form. The name can be changed as long as the new name together with the form name is not the same as that for any display, menu or window object that is being defined within the same screen painting session. If the name is changed such that the form and directory names are the same as that of a form object whose definition already exists in the Data Dictionary, a warning dialog is presented that informs you that saving the definition of the form replaces the existing definition. |
| Form Number | This field contains an identifying number for the form. As the result of an end-user action which triggers an event, the value contained in this field can identify the form in which the event occurred. The value is accessible from the Zim language from the menu context member ThisForm.FormNum, and is one of several means of identifying which form was the source of an end-user event. |
| Form Tag | This field contains an identifying text string for the form. As a result of an end-user action which triggers an event, the value contained in this field can identify the form in which the event occurred. The value is accessible from the Zim language through the event vector members Event.EventTag and Event.FormTag, and also through the form context vector member ThisForm.FormTag. The form tag is one of several means of identifying which form was the source of an end-user event. If left blank, Zim uses the form name to populate these event and context vector members. |
| Tab Index | This field contains a number which represents the relative position of the field in the tab sequence order. A value of zero (0) means use the tab sequence order as defined by the relative position of the field in the structure chart. |
This section displays the attributes related to the instances of repeated forms.
| Down | This field contains the number of repetition instances of the form down the screen. |
| Across | This field contains the number of repetition instances of the form across the screen. |
| Arrangement / Rows | This field is available only if the number of repetitions of the form down and across are both greater than 1; that is, the form instances create a two-dimensional matrix. If this field is selected, Zim populates the form instances by rows, top to bottom. |
| Arrangement / Columns | This field is only available if the number of repetitions of the form down and across are both greater than 1; that is, the form instances create a two-dimensional matrix. If this field is selected, Zim populates the form instances by columns, left to right. |
| OK | This push button performs any required data validation, commits any changes that were made to the form's attributes, and returns to the Screen Painter's layout mode. |
| Cancel | This push button discards any changes that were made in this dialog to the Screen Painter's layout mode. |
| Help | This push button invokes the Zim Help facility, initially displaying the section entitled Edit Form dialog (this section). |