|
GoFiler Legato Script Reference
Legato v 1.6l
Application v 6.6b
|
Chapter
Nine — Dialog Functions
(continued)
STYLE Resource Statement
Overview
The STYLE resource statement defines the window
style of the dialog box. The window style specifies whether the box is a pop-up or a child window.
Syntax/Parameters
Syntax
STYLE style
Parameters
style
The window style bits. This parameter can be an integer value or a combination of window style values
(such as WS_CAPTION and WS_SYSMENU)
and dialog box style values (such as DS_CENTER).
Remarks
The style value is a combination of window styles and dialog specific types. The base window style options are
as follows (upper 16 bits of style):
| |
Definition |
|
Bitwise Value |
|
Description |
|
| |
WS_BORDER |
|
0x00800000 |
|
The window has a thin-line border. |
|
| |
WS_CAPTION |
|
0x00C00000 |
|
The window has a title bar (includes the WS_BORDER
style). |
|
| |
WS_CHILD |
|
0x40000000 |
|
The window is a child window. A window with this style cannot have a menu bar. This style cannot be used with the WS_POPUP
style. |
|
| |
WS_CHILDWINDOW |
|
0x40000000 |
|
Same as the WS_CHILD style. |
|
| |
WS_CLIPCHILDREN |
|
0x02000000 |
|
Excludes the area occupied by child windows when drawing occurs within the parent window. This style is used when creating the parent window. |
|
| |
WS_CLIPSIBLINGS |
|
0x04000000 |
|
Clips child windows relative to each other; that is, when a particular child window receives a WM_PAINT
message, the WS_CLIPSIBLINGS style
clips all other overlapping child windows out of the region of the child window to be updated. If WS_CLIPSIBLINGS
is not specified and child windows overlap, it is possible, when drawing within the client area of a child window,
to draw within the client area of a neighboring child window. |
|
| |
WS_DISABLED |
|
0x08000000 |
|
The window is initially disabled. A disabled window cannot receive input from the user. |
|
| |
WS_DLGFRAME |
|
0x00400000 |
|
The window has a border of a style typically used with dialog boxes. A window with this style cannot have a title bar. |
|
| |
WS_GROUP |
|
0x00020000 |
|
The window is the first control of a group of controls. The group consists of this first control and all controls defined
after it, up to the next control with the WS_GROUP
style. The first control in each group usually has the WS_TABSTOP
style so that the user can move from group to group. The user can subsequently change the keyboard focus from one control
in the group to the next control in the group by using the direction keys. You can turn this style on and off to change dialog
box navigation. |
|
| |
WS_HSCROLL |
|
0x00100000 |
|
The window has a horizontal scrollbar. |
|
| |
WS_ICONIC |
|
0x20000000 |
|
The window is initially minimized. Same as the WS_MINIMIZE
style. |
|
| |
WS_MAXIMIZE |
|
0x01000000 |
|
The window is initially maximized. |
|
| |
WS_MAXIMIZEBOX |
|
0x00010000 |
|
The window has a maximize button. Cannot be combined with the WS_EX_CONTEXTHELP
style. The WS_SYSMENU style must
also be specified. |
|
| |
WS_MINIMIZE |
|
0x20000000 |
|
The window is initially minimized. Same as the WS_ICONIC
style. |
|
| |
WS_MINIMIZEBOX |
|
0x00020000 |
|
The window has a minimize button. Cannot be combined with the WS_EX_CONTEXTHELP
style. The WS_SYSMENU style must
also be specified. |
|
| |
WS_OVERLAPPED |
|
0x00000000 |
|
The window is an overlapped window. An overlapped window has a title bar and a border. Same as the WS_TILED
style. |
|
| |
WS_OVERLAPPEDWINDOW |
|
WS_OVERLAPPED WS_CAPTION WS_SYSMENU WS_THICKFRAME WS_MINIMIZEBOX WS_MAXIMIZEBOX |
|
The window is an overlapped window. Same as the WS_TILEDWINDOW
style. |
|
| |
WS_POPUP |
|
0x80000000 |
|
The windows is a pop-up window. This style cannot be used with the WS_CHILD
style. |
|
| |
WS_POPUPWINDOW |
|
WS_POPUP WS_BORDER WS_SYSMENU |
|
The window is a pop-up window. The WS_CAPTION
and WS_POPUPWINDOW styles must be
combined to make the window menu visible. |
|
| |
WS_SIZEBOX |
|
0x00040000 |
|
The window has a sizing border. Same as the WS_THICKFRAME
style. |
|
| |
WS_SYSMENU |
|
0x00080000 |
|
The window has a window menu on its title bar. The WS_CAPTION
style must also be specified. |
|
| |
WS_TABSTOP |
|
0x00010000 |
|
The window is a control that can receive the keyboard focus when the user presses the TAB key. Pressing the TAB key changes
the keyboard focus to the next control with the WS_TABSTOP
style. |
|
| |
WS_THICKFRAME |
|
0x00040000 |
|
The window has a sizing border. Same as the WS_SIZEBOX
style. |
|
| |
WS_TILED |
|
0x00000000 |
|
The window is an overlapped window. An overlapped window has a title bar and a border. Same as the WS_OVERLAPPED
style. |
|
| |
WS_TILEDWINDOW |
|
WS_OVERLAPPED WS_CAPTION WS_SYSMENU WS_THICKFRAME WS_MINIMIZEBOX WS_MAXIMIZEBOX |
|
The window is an overlapped window. Same as the WS_OVERLAPPEDWINDOW
style. |
|
| |
WS_VISIBLE |
|
0x10000000 |
|
The window is initially visible. |
|
| |
WS_VSCROLL |
|
0x00200000 |
|
The window has a vertical scrollbar. |
|
Dialog specific style bits (lower 16 bits of style):
| |
Definition |
|
Bitwise Value |
|
Description |
|
| |
DS_3DLOOK |
|
0x0004 |
|
Obsolete and kept for compatibility. The system automatically applies the three-dimensional look to dialog boxes
created by applications. |
|
| |
DS_ABSALIGN |
|
0x0001 |
|
Indicates that the coordinates of the dialog box are screen coordinates. If this style is not specified, the coordinates are client coordinates. |
|
| |
DS_CENTER |
|
0x0800 |
|
Centers the dialog box in the working area of the monitor that contains the owner window. If no owner window is specified, the dialog box is centered in the working area of a monitor determined by the system. The working area is the area not obscured by the taskbar or any appbars. |
|
| |
DS_CENTERMOUSE |
|
0x1000 |
|
Centers the dialog box on the mouse cursor. |
|
| |
DS_CONTEXTHELP |
|
0x2000 |
|
Includes a question mark in the title bar of the dialog box. When the user clicks the question mark, the cursor changes
to a question mark with a pointer. If the user then clicks a control in the dialog box, the control receives a WM_HELP
message. The control passes the message to the dialog box help procedure Note that
DS_CONTEXTHELP is only a placeholder. When
the dialog box is created, the system checks for DS_CONTEXTHELP
and, if it is there, adds WS_EX_CONTEXTHELP
to the extended style of the dialog box. WS_EX_CONTEXTHELP
cannot be used with the WS_MAXIMIZEBOX
or WS_MINIMIZEBOX styles. |
|
| |
DS_CONTROL |
|
0x0400 |
|
Creates a dialog box that works well as a child window of another dialog box, much like a page in a property sheet. This style allows the user to tab among the control windows of a child dialog box, use its accelerator keys, and so on. |
|
| |
DS_FIXEDSYS |
|
0x0008 |
|
Causes the dialog box to use the SYSTEM_FIXED_FONT
instead of the default SYSTEM_FONT. |
|
| |
DS_LOCALEDIT |
|
0x0020 |
|
Obsolete and kept for compatibility. |
|
| |
DS_MODALFRAME |
|
0x0080 |
|
Creates a dialog box with a modal dialog box frame that can be combined with a title bar and window menu by specifying
the WS_CAPTION and WS_SYSMENU
styles. |
|
| |
DS_NOFAILCREATE |
|
0x0010 |
|
Creates the dialog box even if errors occur — for example, if a child window cannot be created or if the system cannot create a special data segment for an edit control. |
|
| |
DS_NOIDLEMSG |
|
0x0100 |
|
Suppresses WM_ENTERIDLE messages that
the system would otherwise send to the owner of the dialog box while the dialog box is displayed. Idle message is not
available in Legato scripts. |
|
| |
DS_SETFONT |
|
0x0040 |
|
Indicates that the header of the dialog box template (either standard or extended) contains additional data specifying
the font to use for text in the client area and controls of the dialog box. If possible, the system selects a font according to
the specified font data. The system passes a handle to the font to the dialog box and to each control. |
|
| |
DS_SETFOREGROUND |
|
0x0200 |
|
Causes the system to bring the dialog box to the foreground. This style is useful for modal dialog boxes that require immediate attention from the user regardless of whether the owner window is the foreground window. The system restricts which processes can set the foreground window. |
|
| |
DS_SHELLFONT |
|
DS_SETFONT DS_FIXEDSYS |
|
Indicates that the dialog box should use the system font. The typeface member of the extended dialog box template must
be set to “MS Shell Dlg”. Otherwise, this style has no effect. The system selects a font using the font data specified
in the point size, weight, and italic members. |
|
| |
DS_SYSMODAL |
|
0x0002 |
|
Obsolete and kept for compatibility. |
|
An example of the STYLE statement:
CellName02Dlg DIALOGEX
40, 40, 144, 64
EXSTYLE WS_EX_DLGMODALFRAME | WS_EX_CONTEXTHELP
STYLE DS_MODALFRAME | DS_3DLOOK | WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU
CAPTION "Cell Namespace" FONT 8, "MS Shell Dlg"
See also EXSTYLE resource statement.
Page revised 2026-11-16
© 2012-2026 Novaworks, LLC. All rights reserved worldwide.
Unauthorized use, duplication or transmission is prohibited by law. Portions of the software are protected by US Patents 10,095,672,
10,706,221 and 11,210,456. Novaworks, GoFiler™ and Legato™ are registered trademarks of Novaworks, LLC. EDGAR® is a
federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the
U.S. Securities and Exchange Commission. All other trademarks are the property of their respective owners. Use of the features
specified in this language are subject to terms, conditions and limitations of the Software License Agreement.