Determines a set of properties of the above-mentioned dialog elements. For one instance of a dialog element, several properties may be set. The style of a dialog element is represented by a set of characters. Each character determines a property specific to the dialog element.
| Applies to | ActiveX control, bitmap control, canvas control, column specification control, date/time picker control, dialog (all types), dialog bar control, edit area control, graphic text control, image control, image list control, input field control, line control, list view column, list view control, list view item, OLE container control, progress bar control, push button control, rectangle control, scroll bar control, selection box control, slider control, spin control, status bar control, status bar pane, tab control, table control, text constant control, tool bar, tool bar control, tool bar item, tree view control, tree view item, wallpaper control. |
|---|---|
| Data Type | A253 |
| Value | Meaning |
|---|---|
| O | OK button: is pushed if the end user presses ENTER. |
| C | Cancel button: is pushed if the end user presses ESC. |
| x | Disable accelerators. Disables usage of any accelerator keys defined by the control. |
Note:
The styles "O" and "C" apply only to
ActiveX controls that behave like buttons (i.e., are marked in the system
registry with the style OLEMISC_ACTSLIKEBUTTON).
| Value | Meaning |
|---|---|
| c | Align the bitmap to the center of the dialog element's rectangle. |
| l | Align to the left. |
| r | Align to the right. |
| v | Align to the vertical center. |
| t | Align to the top. |
| b | Align to the bottom. |
| s | Scale the bitmap to fit into the dialog element's rectangle. |
| F | Three-dimensional frame. |
| T | Transparent: Bitmap pixels matching the background color are not drawn. If the background color is specified as "default", the color of the first pixel in the bitmap is assumed to be the background color. |
| Value | Meaning |
|---|---|
| F | Frame (border) around the canvas control (reduces the visible area of the canvas). |
| Value | Meaning |
|---|---|
| F | Framed: Frame around the control box control. |
| L | Lowered: Creates a 3-D border with a sunken appearance. |
| E | Exclusive: Hide all other sibling control boxes with this style automatically when this control is made visible. |
| T | Transparent: (The control itself is not visible, but children may be). |
| z | Size to parent: Resize control to fill parent's client area whenever parent is resized. |
| Value | Meaning |
|---|---|
| s | Short date (default). The control displays date information in the system-defined short date format, which may or may not include century information. |
| c | Century date. The control displays date information in the
system-defined short date format, but with century information.
Note: |
| 1 | Long date. The control displays date information in the system-defined long date format. |
| Value | Meaning |
|---|---|
| g | Gripper: Control has a gripper bar. |
| Y | Dynamic: Control can be resized when floated or docked. |
| 3 | 3-D border: Dialog interior drawn with sunken 3-D appearance. |
| R | Raised: Control has a raised interior. |
| x | Control has a close button. |
| z | Control has a zoom button. |
| T | UI Transparent: The control can only be dragged via the gripper bar (if present) and not via clicking elsewhere in the control. |
| Value | Meaning |
|---|---|
| c | Center dialog on screen. |
| P | Modeless (Pop-up; window is independent of its parent). |
| m | Modal. |
| x | Dialog box. |
| r | Relative position: The position is interpreted as being relative to the parent (owner) dialog. |
| d | Default position; will be ignored if "Dialog box" is set as well. |
| D | Default rectangle; will be ignored if "Dialog box" is set as well. |
| Z | Control clipping. Prevents controls overprinting other controls which are "in front" in the so-called Z order. The position of a control in the Z-order sequence is determined via the control's SUCCESSOR attribute. |
| 3 | 3-D border: Dialog interior drawn with sunken 3-D appearance. |
| p | Property sheet-like navigation: If the dialog contains a tab control, the Ctrl-Tab and Ctrl-Shift-Tab key combinations are used for browsing forwards and backwards (respectively) between the tab control's tabs. |
| Value | Meaning |
|---|---|
| w | Wordwrapped (if text exceeds the width of the edit area control, it is automatically wrapped to the next line). |
| F | Frame around the edit area control. |
| v | Autoscroll: Text is automatically scrolled upwards if ENTER key
is pressed on the last displayed line. This style also enables scrolling in the
absence of a vertical scroll bar (e.g. via cursor keys or mouse wheel).
Note: |
| Value | Meaning |
|---|---|
| p | Group frame becomes parent of any controls placed within it. |
| Value | Meaning |
|---|---|
| s | Scaled. If the required width or height of the rendered image differ from the width or height of the image(s) taken from the image file, the images are scaled, rather than being either extended in the background color or truncated. |
| T | Transparent. Image is rendered transparently. For bitmap image files (*.bmp), bitmap pixels matching the background color are not drawn. If the background color is specified as "default", the color of the first pixel in the bitmap is assumed to be the background color. For icon image files (*.ico), where the background color is "default" and no scaling needs to be performed on the image, the transparency mask provided with the icon is used. Otherwise, the icon's bitmap is handled as for bitmap image files and the transparency mask is ignored. |
| C | Composite image. Image bitmap file assumed to consist of multiple images joined together horizontally into one large bitmap, based on the image list's ITEM-H and ITEM-W attributes, or (if zero) the system small icon size if the image list's "Small images (S)" style is specified, or the system large icon size (typically 32 by 32 pixels) if the image list's "Large images (L)" style is specified. If none of these are specified, the system small icon size (typically 16 by 16 pixels) is assumed. This style cannot be used for icon image files. |
| O | Overlay image. An overlay images is an images that may be superimposed on the base image displayed for an item. Overlay images may be specified via the OVERLAY and/or OVERLAY-INDEX attributes, and are always implicitly rendered transparently. |
| Value | Meaning |
|---|---|
| L | Large images. Indicates that the image list consists of images corresponding to the system large icon size (typically 32 by 32 pixels). This should be set if the image list is used to source large icons for a control (e.g., for the Icon view mode of a list view control). |
| S | Small images. Indicates that the image list consists of images corresponding to the system small icon size (typically 16 by 16 pixels). This should be set if the image list is used to provide small icons for a control (e.g., for a tree view control). |
Notes:
| Value | Meaning |
|---|---|
| l | Left-justified input. |
| r | Right-justified input. |
| c | Horizontally centered input. |
| N | Non-displayed input (for example, for passwords). |
| U | Upper-case input. Input is converted to upper case. |
| L | Lower-case input. Input is converted to lower case. |
| M | Input is mandatory. |
| d | Digits only. Only the digits 0.. 9 may be input. |
| Value | Meaning |
|---|---|
| S | Solid line (default). |
| - | Dashed line pattern. |
| . | Dotted line pattern. |
| ! | Dash-dot line pattern. |
| : | Dash-dot-dot line pattern. |
| Value | Meaning |
|---|---|
| 3 | 3-D border: Border with sunken 3-D appearance around the list box control. |
| I | Integral height. Partial rows are not displayed. |
| i | Insertion mark. An insertion mark appears indicating the would-be insert position when the list box is used as a target in a drag-drop operation and a drop is allowed. |
| Value | Meaning |
|---|---|
| 3 | 3-D border: Border with sunken 3-D appearance around the list view control. |
| v | Align vertically. Items are arranged vertically (instead of horizontally) in the icon view modes. |
| a | Auto-arrange. Items are always automatically kept arranged in the icon view modes. |
| r | Snap to grid. (Re-)positioned items are automatically snapped to their nearest grid position in the icon view modes. |
| n | No scroll. Disables both horizontal and vertical scrolling in the control. The control will not display any scroll bars. |
| x | No header. No column headers are displayed in report view mode. |
| y | No sort header. List view columns may not be sorted by clicking their header (i.e., the column headers are not click-sensitive). |
| c | Check boxes. Check boxes are displayed for all items. The checked state may be queried or changed via the CHECKED attribute for a list view item. |
| f | Full row select. Selection emphasis extends across all columns in report view mode, and it is possible to select an item by selecting anywhere within the row. |
| g | Grid lines. Grid lines are displayed in the report view. |
| d | Header drag. The user may re-order columns in the report view by dragging their headers. |
| p | Label tip. If not enough space exists to display an items label
completely, the full label is displayed in a tooltip window when the mouse
cursor hovers over the label.
Note: |
| w | Wrap icon labels (default). Long item labels may be wrapped to spread over multiple lines. |
| u | Underline hot. Label of item under mouse cursor (if any) is underlined and emphasized in a different color. Only a single click is needed to activate items. |
| U | Underline cold. All items labels are underlined. Only a single click is needed to activate items. |
| s | No hide selection. Keep selection visible even when the control does not have the focus. |
| b | Border select. Use thick border to highlight selected items in icon view mode. No dot screen is applied over the selected icons in any mode, thus making them more legible. |
| t | Hot-track select. The item under the mouse cursor is selected automatically if the mouse cursor hovers over it for a short time. |
| m | Marquee select (default). In multiple selection list views, items may be selected by "rubber banding" (i.e., defining a drag rectangle containing the items to be selected). |
| z | Size to parent: Resize control to fill parent's client area whenever parent is resized. |
| Value | Meaning |
|---|---|
| 1 | Left. Column title is left-aligned (default). |
| c | Center. Column title is centered. This option has no effect on the primary column (the column containing the item labels). |
| r | Right. Column title is right-aligned. This option has no effect on the primary column (the column containing the item labels). |
| i | Case insensitive. Columns containing alphanumeric data are sorted case-insensitively. By default, the sort is case-sensitive. |
| w | Word compare. Columns containing alphanumeric data are sorted using a word compare. By default, a simple string comparison is made. In a word compare, the hyphen and the apostrophe characters are treated differently, in order to ensure that words such as "coordinate" and "co-ordinate" stay together within a sorted list. |
| Value | Meaning |
|---|---|
| U | Upper case. When an item label is edited, lower-case characters are automatically converted to upper-case. Note that this option does not apply to text that is set programatically, via the item's STRING attribute. |
| Value | Meaning |
|---|---|
| s | Scaled: Bitmaps are scaled to match the image height and width specified for the parent menu. |
| T | Transparent: Bitmap pixels matching the background color are not drawn. If the background color is specified as "default", the color of the first pixel in the bitmap is assumed to be the background color. |
| D | Default: Menu item text is displayed in a bold font. |
| Value | Meaning |
|---|---|
| F | Framed: Frame around the OLE container control. |
| Value | Meaning |
|---|---|
| s | Smooth. The control's progress bar is non-segmented.
Note: |
| v | Vertical. The control is oriented vertically, rather than horizontally. |
| Value | Meaning |
|---|---|
| O | OK button: is pushed if the end user presses ENTER. |
| C | Cancel button: is pushed if the end user presses ESC. |
| Value | Meaning |
|---|---|
| h | Slider will scroll horizontally. |
| v | Slider will scroll vertically. |
Note:
When you edit the STYLE attribute value in the scroll bar control
attributes window, setting "h" instead of
"v" and vice versa, the RECTANGLE-H and RECTANGLE-W attribute values are exchanged. The
dialog editor thus ensures that the scroll bar control will not provide for
vertical scrolling in a horizontal shape and vice versa.
| Value | Meaning |
|---|---|
| M | Input into this selection box control is mandatory. |
| X | Box is pulled down all the time. |
| U | Upper-case input. |
| Value | Meaning |
|---|---|
| a | Auto ticks (default). Tick marks are displayed automatically, at
intervals determined by the control's SPACING attribute. If this option is not
specified, tick marks must be explicitly added via the
SET-TICKS action.
Note: |
| 1 | Side 1 ticks (default). Tick marks are displayed at the top or left side of the control, if the control is oriented horizontally or vertically (respectively). |
| 2 | Side 2 ticks. Tick marks are displayed at the bottom or right side of the control, if the control is oriented horizontally or vertically (respectively). |
| v | Vertical. The control is oriented vertically, rather than horizontally. |
| p | Position tip. When the slider is used, a toolip window is shown to indicate the current position. |
| n | No thumb. The control does not display a thumb. |
| Value | Meaning |
|---|---|
| h | Horizontal. The control is oriented horizontally rather than vertically. |
| 1 | Left align. The control has an implicit buddy input field control that is displayed to the right of the control's Up and Down buttons. |
| r | Right align (default). The control has an implicit buddy input field control that is displayed to the left of the control's Up and Down buttons. |
| s | Set buddy (default). The contents of the buddy input field control (if any) are automatically updated to reflect the spin control's position. |
| w | Wrap. When the control's upper limit has been reached, the control's value automatically wraps around to the lower limit, and vice versa. |
| k | Arrow keys (default). Causes the control to increment or decrement the position when the Up Arrow and Down Arrow keys are pressed, respectively. |
| n | No thousands (default). Thousands separators are not used. For
example, "1,200,000" is displayed as "1200000" in the
buddy input field control (if any).
Note: |
| t | Hot tracking. Causes the up and down arrow buttons to be
highlighted when the mouse cursor moves over them.
Note: |
| x | Hexadecimal. The buddy input field control (if any) displays
values in hexadecimal (rather than decimal) notation (e.g.,
"0x001E" instead of "30").
Note: |
| Value | Meaning |
|---|---|
| 3 | 3-D border: border will be drawn with a 3-D appearance. |
| t | Top border: border will be drawn along top edge of control. |
| b | Bottom border: border will be drawn along bottom edge of control. |
| g | Gripper: control has a sizing grip. |
| Value | Meaning |
|---|---|
| c | Centered: text will be centered within the pane. |
| H | Hide pane text (instead of graying it out) if pane is disabled. |
| R | Raised: pane will be drawn with a raised 3-D appearance. |
| n | No borders: pane will be drawn without borders. |
| Value | Meaning |
|---|---|
| c | Cool menu: menu items are drawn with their bitmap (if any). |
| F | Keep focus: the focus is not automatically transferred to the clicked dialog element. This style applies to context menus only. |
| Value | Meaning |
|---|---|
| b | Bottom tabs: Tabs are displayed at the bottom of the control instead of at the top. |
| f | Fixed-width tabs: All tabs have a constant width, as specified by
the ITEM-W attribute.
Note: |
| m | Multi-row: Tabs are arranged in multiple rows, if necessary, instead of being on a single (scrollable) row. |
| R | Ragged: Tab widths are not automatically extended for tab controls with the "multi-row" style to ensure that the left and right edges of each tab row are aligned to the corresponding edges of the control. |
| x | Left icon: The tab's icon (if any) is left-aligned. |
| y | Left label: The tab's label is left-aligned. This style automatically implies the "left icon" style. |
| z | Browsable: The control can receive the focus, whereupon the active tab is drawn with focus emphasis. It is then possible to navigate (browse) between the tabs using the cursor (arrow) keys. |
| U | UI active: Switching between tabs is possible in the dialog editor. In addition, any controls created within the tab control are owned by the currently selected tab (see OWNER attribute) and are automatically hidden and shown when this tab is deselected and re-selected, respectively (both in the editor and at run-time). |
| - | Disable theme: Disables the standard tab control theme (if any) used for drawing the control. The control appears in the "Classic" Windows style. Note that this style has no effect on Windows versions prior to Windows XP. |
| Value | Meaning |
|---|---|
| h | Columns header: buttons with field names are displayed at the top of each column. |
| I | Integral height: partial rows are not displayed. |
| n | No lines: the table control is displayed without the lines that normally separate the cells. |
| s | Single cell selection: If this attribute is set, end users may only select single cells. If not set, end users may select ranges of cells. |
| w | Whole row selection: selecting an individual cell sets the selection to the entire row. |
| e | Extendable: end users can delete and insert rows using DEL and INS. |
| c | Resize columns: end users may resize the columns horizontally. |
| r | Resize rows: end users may resize the rows vertically. |
| d | Draggable columns: If this attribute is set, end users may drag the columns. |
| Value | Meaning |
|---|---|
| l | Left-justified input. |
| r | Right-justified input. |
| c | Horizontally centered input. |
| F | Frame around the text constant control. |
| Value | Meaning |
|---|---|
| w | Wrapped: if set and there are more tool bar items than can be displayed on the top of the dialog, the tool bar wraps around to a new line. (The default: the tool bar can be scrolled with the two small arrow push buttons on the left of the tool bar). |
| Value | Meaning |
|---|---|
| 3 | 3-D border: border will be drawn with a 3-D appearance. |
| t | Top border: border will be drawn along top edge of control. This style is implicitly set for dockable tool bar controls. |
| b | Bottom border: border will be drawn along bottom edge of control. This style is implicitly set for dockable tool bar controls. |
| l | Left border: border will be drawn along left edge of control. This style is implicitly set for dockable tool bar controls. |
| r | Right border: border will be drawn along right edge of control. This style is implicitly set for dockable tool bar controls. |
| g | Gripper: control has a gripper bar. |
| L | Tool bar items are drawn with a flat (rather than raised) appearance. |
| Y | Dynamic: tool bar control can be resized when floated, but cannot contain any child controls. |
| Value | Meaning |
|---|---|
| s | Scaled: bitmaps are scaled to fit on the tool bar items. |
| T | Transparent: Bitmap pixels matching the background color are not drawn. If the background color is specified as "default", the color of the first pixel in the bitmap is assumed to be the background color. |
| Value | Meaning |
|---|---|
| 3 | 3-D border: Border with sunken 3-D appearance around the list view control. |
| b | +/- buttons. Displays plus (+) and minus (-) buttons next to
parent items. The user can click these buttons to expand or collapse a parent
item's list of child items.
Note: |
| 1 | Lines. Lines are used to show the item hierarchy. |
| r | Lines at root. Lines are used to link items at the root of the item hierarchy. |
| n | No scroll. Disables both horizontal and vertical scrolling in the control. The control will not display any scroll bars. |
| x | Single expand. Items are automatically expanded when selected, and automatically collapsed when deselected (unless the >Ctrl< key is being held down). Clicking again on a selected item causes the item to be collapsed. |
| d | Double click expand (default). An item may be expanded by double-clicking it. |
| c | Check boxes. Check boxes are displayed for all items. The checked state may be queried or changed via the CHECKED attribute for a list view item. |
| f | Full row select. Selection emphasis extends across the entire control, and it is possible to select an item by selecting anywhere within the "row" containing the item. |
| s | No hide selection. Keep selection visible even when the control does not have the focus. |
| t | Hot-track select. The item under the mouse cursor is selected automatically if the mouse cursor hovers over it for a short time. |
| z | Size to parent: Resize control to fill parent's client area whenever parent is resized. |
| Value | Meaning |
|---|---|
| U | Upper case. When an item label is edited, lower-case characters are automatically converted to upper-case. Note that this option does not apply to text that is set programatically, via the item's STRING attribute. |
| n | No check box. No check box is displayed for this item.
Note: |
| Value | Meaning |
|---|---|
| c | Align the bitmap to the center of the host dialog or dialog "pattern"element's client area. Like the other alignment styles, this style does not apply if the style is set. |
| l | Align to the left. |
| r | Align to the right. |
| v | Align to the vertical center. |
| t | Align to the top. |
| b | Align to the bottom. |
| p | Pattern: The wallpaper bitmap is repeated (tiled) to fill the entire client area of the host dialog or dialog element. |
| T | Transparent: Bitmap pixels matching the background color are not drawn. If the background color is specified as "default", the color of the first pixel in the bitmap is assumed to be the background color. |
