Accessible Using
Double-click on the edit area control; or
if selected: "Control > Attributes" or by selecting 'Attributes...' from the control's context menu or
if selected: ENTER.
Note:
For context-sensitive help on attribute entries, select the entry so
it has the focus, and press F1.
| Entry in Attributes Window | Represents |
|---|---|
| Name | Handle name of the dialog bar control. |
| String | STRING attribute value. This is the text displayed in the window caption when a dockable dialog bar control is floated. |
| Control ID | CLIENT-KEY attribute value (used in this context for associating a user-defined ID). |
| Context Menu | CONTEXT-MENU attribute value. Specifies the context menu (if any) associated with the control. |
| Wallpaper | WALLPAPER attribute value. Specifies the wallpaper (if any) associated with the dialog bar control. |
| Docking | DOCKING
attribute value. Determines the sides of the dialog (if any) on which this
dialog bar control is allowed to dock (if dockable).
Note: |
| Location | LOCATION attribute value. Determines the side of the dialog on which the dialog bar control is initially positioned, or whether the dialog bar control is floated in a separate window (if dockable). |
| Help ID | HELP-ID attribute value. You must use the help topic's .h file to map the numerical ID that you enter here to the corresponding help topic ID (created by a markup in the .hlp file). |
| Background color: | |
| Selection box | BACKGROUND-COLOUR-NAME attribute value. |
... |
Invokes dialog box for editing BACKGROUND-COLOUR-VALUE attribute value. |
| Internal Metrics: | |
| Margin-X | MARGIN-X attribute value. Specifies the margin (in pixels) on the left and right of the dialog bar control. |
| Margin-Y | MARGIN-Y attribute value. Specifies the margin (in pixels) at the top and bottom of the dialog bar control. |
| Borders: | |
| Left | STYLE attribute value. Specifies whether a border should be displayed on the left side of the control. This option is not available for dockable dialog bars. |
| Top | STYLE attribute value. Specifies whether a border should be displayed at the top of the control. This option is not available for dockable dialog bars. |
| Right | STYLE attribute value. Specifies whether a border should be displayed on the right side of the control. This option is not available for dockable dialog bars. |
| Bottom | STYLE attribute value. Specifies whether a border should be displayed at the bottom of the control. This option is not available for dockable dialog bars. |
| Style: | |
| Gripper | STYLE attribute
value. Determines whether a gripper bar is displayed within the dialog bar
control.
Note: |
| Dynamic | STYLE attribute value. Indicates that the dialog bar control can be resized when floated or docked. |
| 3-D border | STYLE attribute value. If set, the dialog bar control's border (if any) is drawn with a 3-D appearance. |
| Raised | STYLE attribute value. If set, the dialog bar control is drawn with a raised interior. |
| Close button | STYLE attribute value. If set, the dialog bar control is drawn with a close button (which actually hides the dialog bar, rather than closing it). |
| Zoom button | STYLE attribute value. If set, the dialog bar control can only be dragged via the gripper bar (if any), and not also via the dialog bar control's background. |
| UI Transparent | STYLE attribute value. If set, the dialog bar control is drawn with a close button (which actually hides the dialog bar, rather than closing it). |
| State: | |
| Visible | VISIBLE attribute value. |
| Enabled | ENABLED attribute value. |
| Dockable | DRAGGABLE attribute value. If set, the dialog bar control may be docked and/or floated in its own separate window. |
| Maximized | MAXIMIZED attribute value. If you check this entry, the dialog bar control is expanded to fill the maximum amount of space available on the row. If you check this entry, this and the other dialog bar controls on the row are restored to their previous size. This option is only available if two or more dynamic dialog bar controls are on the same row. |
| Rectangle: | The following four attributes decide the dialog bar control's x
and y axis position, its height and its width on the screen.
X -
RECTANGLE-X attribute
value. |
| OK | Save settings and exit the window. |
| Cancel | Exit the window without saving the settings. |
| Help | Provides online help on the attributes window. |
