STYLE Resource Statement

GoFiler Legato Script Reference

Legato v 1.5d

Application v 5.25a

Table of Contents	< < Previous	Next >>

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: