The Edit Graphic Dialog

The Edit Graphic dialog can be displayed by either double clicking anywhere within a graphic form field object or selecting the graphic field and clicking on the "attribute edit" icon in the tool bar. This dialog presents the current attributes of the graphic field. The dialog consists of three sections: identification, appearance, and properties.

Identification Section

This section displays naming and other identifying information for the graphic form field object.

Field Name

This field contains the name of the graphic field. 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 graphic field 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 graphic field 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 graphic field. The value in this field can be used to identify the graphic field 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 graphic field. The value in this field can be used to identify the graphic field 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 graphic field receives the input focus. The message which 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 forms, enter an appropriate help message text in this Help Message field.

Appearance Section

This section presents the display or appearance attributes of the graphic form field object.

Visible

This check box determines if the scroll bar is visible by default. The visibility attribute of all form fields other than labels and graphics may be dynamically modified under Zim program control.

Style / Graphic

This field determines the type of graphic object. The values are "horizontal line", "vertical line", "rectangle", "rounded rectangle", "ellipse" and "diamond".

Style / Pen Width

This field determines the width of the graphic line. The values range from a "hairline" (a single pixel wide in all screen resolutions) to 10 Points.

Properties Section

This section presents the behavioral attributes of the graphic form field object.

Availability

This field cannot be modified for graphic form fields.

Tab Stop

This field cannot be modified for graphic form fields.

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.

Dialog Push Buttons

OK

This push button performs any required data validation, commits any changes that were made in this dialog, 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 Graphic dialog (this section).