The Edit Push Button dialog can be displayed by either double clicking anywhere within a push button form field object, or selecting the push button and clicking on the "attribute edit" icon in the tool bar. This dialog presents the current attributes of the push button. The dialog consists of three sections: identification, appearance, and properties.
This section displays naming and other identifying information for the push button form field object.
| Field Name | This field contains the name of the push button. The Screen Painter automatically generates a unique name for it. This name can be maintained or changed, as long as the new name conforms to the Zim Object Naming Rules. |
| Form Name | This field contains the name of the form in which the push button was created. The field can be viewed by selecting it and scrolling left and right, but its value cannot be changed. |
| Directory | This field contains the name of the Zim directory that owns the form in which the push button was created. The field can be viewed by selecting it and scrolling left and right, but its value cannot be changed. |
| Field Number | This field contains an automatically generated identifying number for the push button. The value in this field can be used to identify the push button if it triggers a callback event. Refer to Form Fields and Callback Events for more detailed information about associating form fields with callback events. The value in this field can be changed and need not be unique. |
| Field Tag | This field contains an identifying text string for the push button. The value in this field can be used to identify the push button if it triggers a callback event. Refer to Form Fields and Callback Events for more detailed information about associating form fields with callback events. The value in this field can be changed and need not be unique. If left blank (the default), the value contained in Field Name is used for Field Tag. |
| Help Message | This field contains the text to display in an field of type "message" (if one exists in the form) when the push button receives the input focus. The message that appears at the bottom left of this dialog is itself a "message" field, and the help message associated with each field in the dialog is automatically displayed there when the field receives the input focus. If you intend to have a "message" field in your form, enter an appropriate help message text in this Help Message field. |
This section presents the display or appearance attributes of the push button form field object.
|
Visible |
This check box determines if the push button is visible by default. The visibility attribute of all form fields other than labels can be dynamically modified under Zim program control. |
|
Pointer Style |
This list box is used to select the pointer (or cursor) style to use when the pointer is over or in the push button, and the push button is available. By default, the value is "default", which for a push button field, is the "Arrow" pointer style. |
|
Style / Button Type |
This list box provides for the selection of text based, or image based push buttons. The values are "Text" and "Image". If "Text" is selected then the field Label is available only within the Style sub-section. If "Image" is selected, then the fields Auto Size, Image Type and Select... become available, and the Label field is replaced by the field Image File Name. Text push buttons correspond to familiar OK, Cancel etc. push buttons. Image push buttons are functionally identical except that instead of using text to indicate their purpose, an appropriate image is used. |
|
Style / Image Type |
This list box is applicable only to "Image" type push buttons. It can be used to select from the three supported image file types, "Bit Map", "(Windows) Meta File", and "Icon". |
|
Style / Auto Size |
This entry field is applicable only to "Image" type push buttons. It can be used to select from four different automatic image sizing options. These are "None-clipped", "Image to object", "Image proportional" and "Object to image". Refer to Image Auto Size Options for more detailed information about the different automatic image sizing options. |
|
Style / Label |
This entry field is applicable only to "Text" type push buttons. It contains the text string which is to appear on the push button. |
|
Style / Image File Name |
This field is applicable only to "Image" type push buttons. It contains the full path name of the file that contains the image which is to appear on the push button. Refer to File Path Prefix Characters for information about the directory path prefix characters available within the painter and within Zim itself. |
|
Style / Select |
This push button is applicable only to "Image" type push buttons. It invokes the Windows "File/Select" common dialog with the caption Select Push Button Image File, and places the contents of Image File Name in the File Name field. If Image File Name is prefixed by one of the special file path prefix characters, then the directory list is positioned within the appropriate directory. Otherwise the directory list is positioned within the directory specified by the full path name of Image File Name. If the file selected from this dialog is located in one of the special directories, its directory path name is replaced by one of the file path prefix characters. Otherwise, the full path name of the file is preserved. |
This section presents the behavioral attributes of the entry field object.
| Availability | This field determines the "availability" attribute of the push button field. The values are "Available", "Unavailable", "Guarded" and "Protected". Refer to Form Field Availability Attributes for a more detailed description of the characteristics of these different availability values. |
| Tab Stop | This check box field determines if the push button is included in the tab order. If cleared, the end-user is not able to access this field by using the tab keys. The push button is still directly accessible by accelerator keys and the mouse. |
| Tab Index | This field contains a number that 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. |
| Default Button | This check box determines if the push button is the default push button. The default push button has a larger surrounding border than other push buttons and is the push button considered to have the input focus when the enter key is pressed, so long as no other push button currently has the input focus. There can only be one default push button within a form or display. |
| OK | This push button performs any required data validation, commits any changes that were made to the push button field's attributes, and returns to the Screen Painter's layout mode. |
| Cancel | This push button discards any changes that were made in this dialog and returns to the Screen Painter's layout mode. |
| Help | This push button invokes the Zim Help facility, initially displaying the section entitled Edit Push Button dialog (this section). |
| Options | This push button display the Push Button Options dialog that enables additional attributes of the push button field to be viewed and modified. |