The Edit Scroll Bar dialog can be displayed by either double clicking anywhere within a scroll bar form field object or selecting the scroll bar field and clicking on the "attribute edit" icon in the tool bar. This dialog presents the current attributes of the scroll bar. The dialog consists of three sections: identification, appearance, and properties.
This section displays naming and other identifying information for the scroll bar form field object.
| Field Name | This field contains the name of the scroll bar. 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 scroll bar 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 scroll bar 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 scroll bar. The value in this field can be used to identify the scroll bar 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 scroll bar. The value in this field can be used to identify the scroll bar 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 scroll bar 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 forms, enter an appropriate help message text in this Help Message field. |
This section presents the display or appearance attributes of the scroll bar form field object.
| Visible | This check box determines if not the scroll bar 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 field can be used to select the pointer (or cursor) style to use when the pointer is over or in the scroll bar, and the scroll bar is available. By default, the value is "default", which for a scroll bar, is the "Arrow" pointer style. |
| Style / Orientation | This field determines the scroll bar's orientation. The values are "Vertical" and "Horizontal". |
| Style / Standard Dimensions | This field determines if the width of the scroll bar's trough is constrained to the standard Windows dimensions or is resizeable to any desired dimensions. The scroll bar's length is always resizeable. |
This section presents the behavioral attributes of the scroll bar form field object.
| Availability | This field determines the "availability" attribute of the scroll bar. 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 field determines if the scroll bar is included in the tab order for the form. If cleared, the end-user is not able to access this field by using the tab keys. The scroll bar 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. |
| Value / Min | This field contains the data value associated with the scroll bar when the "bar" component is at its left-most (for horizontal) or top-most (for vertical) position in the scroll "trough". |
| Value / Max | This field contains the data value associated with the scroll bar when the "bar" component is at its right-most (horizontal) or bottom-most (vertical) position in the "trough" component. |
| Value / Default | This field contains the default value for the scroll bar. This value represents the default position of the "bar" within the "trough". By default, this value is the equal to Value / Min, which means that the "bar" is positioned at the left-most (horizontal) or top-most (vertical) position within the "trough". Other values for this field are acceptable as long the value is greater than or equal to Value / Min and less than or equal to Value / Max. |
| Value / Small Increment | This field contains the incremental value of the scroll bar field when the scroll bar is activated by clicking on the left and right (for horizontal; top and bottom for vertical) arrows. A single click on the arrows causes the current value of the scroll bar field to increase or decrease by Value / Small Increment. |
| Value / Large Increment | This field contains the incremental value of the scroll bar field when the scroll bar is activated by clicking within the left and right (for horizontal; top and bottom for vertical) sections of the trough. A single click within the trough causes the current value of the scroll bar field to increase or decrease by Value / Large Increment. |
| 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 Scroll bar dialog (this section). |
| Options | This push button displays the Scroll Bar Options dialog that enables additional attributes of the scroll bar to be viewed and modified. |