Dialog Bar Control Attributes Window

Start of instruction setAccessible Using

  1. Double-click on the edit area control; or

  2. if selected: "Control > Attributes" or by selecting 'Attributes...' from the control's context menu or

  3. if selected: ENTER.


Entries

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:
The dialog itself must also support docking on the specified side(s).

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:
The gripper bar does not appear if the dialog bar control is floated.

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.
Y - RECTANGLE-Y attribute value.
W - RECTANGLE-W attribute value.
H - RECTANGLE-H 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.