Dialog Bar Control Attributes Window

Start of instruction set 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.

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.
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.