STYLE Statement

The STYLE resource-definition statement sets the window style of the dialog box. The window style specifies whether the box is a pop-up or a child window.

Syntax

STYLE style

Parameters

style

Specifies the window style. This parameter takes an integer value or predefined name. The default style is WS_POPUP | WS_BORDER | WS_SYSMENU.

The following is a list of the predefined styles:

Style Description

DS_LOCALEDIT Specifies that edit controls in the dialog box will use memory in the application's data section. By default, all edit controls in dialog boxes use memory outside the application's data section. This feature can be suppressed by adding the DS_LOCALEDIT flag to the STYLE command for the dialog box. If this flag is not used, the EM_GETHANDLE and EM_SETHANDLE messages must not be used.

DS_MODALFRAME 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_NOIDLEMSG Suppresses WM_ENTERIDLE messages that the system would otherwise send to the owner of the dialog box while the dialog box is displayed.

DS_SYSMODAL Create a dialog box with the WS_EX_TOPMOST flag. This flag cannot be combined with the DS_CONTROL style. This flag is obsolete and is included for compatibility with 16-bit versions of Windows.

WS_BORDER Creates a window that has a border.

WS_CAPTION Creates a window that has a title bar (implies the WS_BORDER style).

WS_CHILD Creates a child window. It cannot be used with the WS_POPUP style.

WS_CHILDWINDOW Creates a child window that has the WS_CHILD style.

WS_CLIPCHILDREN Excludes the area occupied by child windows when drawing within the parent window. Used when creating the parent window.

WS_CLIPSIBLINGS Clips child windows relative to each other; that is, when a particular child window receives a WM_PAINT message, this style clips all other top-level child windows out of the region of the child window to be updated. (If the WS_CLIPSIBLINGS style is not given and child windows overlap, it is possible, when drawing in the client area of a child window, to draw in the client area of a neighboring child window.) For use with the WS_CHILD style only.

WS_DISABLED Creates a window that is initially disabled.

WS_DLGFRAME Creates a window with a modal dialog box frame but no title.

WS_GROUP Specifies the first control of a group of controls in which the user can move from one control to the next by using the arrow keys. All controls defined with the WS_GROUP style after the first control belong to the same group. The next control with the WS_GROUP style ends the style group and starts the next group (that is, one group ends where the next begins). This style is valid only for controls.

WS_HSCROLL Creates a window that has a horizontal scroll bar.

WS_ICONIC Creates a window that is initially iconic. For use with the WS_OVERLAPPED style only.

WS_MAXIMIZE Creates a window of maximum size.

WS_MAXIMIZEBOX Creates a window that has a maximize button.

WS_MINIMIZE Creates a window of minimum size.

WS_MINIMIZEBOX Creates a window that has a minimize button.

WS_OVERLAPPED Creates an overlapped window. An overlapped window has a caption and a border.

WS_OVERLAPPED
WINDOW Creates an overlapped window having the WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX, and WS_MAXIMIZEBOX styles.

WS_POPUP Creates a pop-up window. It cannot be used with the WS_CHILD style.

WS_POPUPWINDOW Creates a pop-up window that has the WS_POPUP, WS_BORDER, and WS_SYSMENU styles. The WS_CAPTION style must be combined with the WS_POPUPWINDOW style to make the System menu visible.

WS_SIZEBOX Creates a window that has a size box. Used only for windows with a title bar or with vertical and horizontal scroll bars.

WS_SYSMENU Creates a window that has a window menu in its title bar. Used only for windows with title bars. If used with a child window, this style creates a close button instead of a window menu.

WS_TABSTOP Specifies one of any number of controls through which the user can move by using the TAB key. The TAB key moves the user to the next control specified by the WS_TABSTOP style. This style is valid only for controls.

WS_THICKFRAME Creates a window with a thick frame that can be used to size the window.

WS_VISIBLE Creates a window that is initially visible. This applies to overlapping and pop-up windows. For overlapping windows, the y parameter is used as a parameter for the ShowWindow function.

WS_VSCROLL Creates a window that has a vertical scroll bar.

Style	Description
DS_LOCALEDIT	Specifies that edit controls in the dialog box will use memory in the application's data section. By default, all edit controls in dialog boxes use memory outside the application's data section. This feature can be suppressed by adding the DS_LOCALEDIT flag to the STYLE command for the dialog box. If this flag is not used, the EM_GETHANDLE and EM_SETHANDLE messages must not be used.
DS_MODALFRAME	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_NOIDLEMSG	Suppresses WM_ENTERIDLE messages that the system would otherwise send to the owner of the dialog box while the dialog box is displayed.
DS_SYSMODAL	Create a dialog box with the WS_EX_TOPMOST flag. This flag cannot be combined with the DS_CONTROL style. This flag is obsolete and is included for compatibility with 16-bit versions of Windows.
WS_BORDER	Creates a window that has a border.
WS_CAPTION	Creates a window that has a title bar (implies the WS_BORDER style).
WS_CHILD	Creates a child window. It cannot be used with the WS_POPUP style.
WS_CHILDWINDOW	Creates a child window that has the WS_CHILD style.
WS_CLIPCHILDREN	Excludes the area occupied by child windows when drawing within the parent window. Used when creating the parent window.
WS_CLIPSIBLINGS	Clips child windows relative to each other; that is, when a particular child window receives a WM_PAINT message, this style clips all other top-level child windows out of the region of the child window to be updated. (If the WS_CLIPSIBLINGS style is not given and child windows overlap, it is possible, when drawing in the client area of a child window, to draw in the client area of a neighboring child window.) For use with the WS_CHILD style only.
WS_DISABLED	Creates a window that is initially disabled.
WS_DLGFRAME	Creates a window with a modal dialog box frame but no title.
WS_GROUP	Specifies the first control of a group of controls in which the user can move from one control to the next by using the arrow keys. All controls defined with the WS_GROUP style after the first control belong to the same group. The next control with the WS_GROUP style ends the style group and starts the next group (that is, one group ends where the next begins). This style is valid only for controls.
WS_HSCROLL	Creates a window that has a horizontal scroll bar.
WS_ICONIC	Creates a window that is initially iconic. For use with the WS_OVERLAPPED style only.
WS_MAXIMIZE	Creates a window of maximum size.
WS_MAXIMIZEBOX	Creates a window that has a maximize button.
WS_MINIMIZE	Creates a window of minimum size.
WS_MINIMIZEBOX	Creates a window that has a minimize button.
WS_OVERLAPPED	Creates an overlapped window. An overlapped window has a caption and a border.
WS_OVERLAPPED WINDOW	Creates an overlapped window having the WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX, and WS_MAXIMIZEBOX styles.
WS_POPUP	Creates a pop-up window. It cannot be used with the WS_CHILD style.
WS_POPUPWINDOW	Creates a pop-up window that has the WS_POPUP, WS_BORDER, and WS_SYSMENU styles. The WS_CAPTION style must be combined with the WS_POPUPWINDOW style to make the System menu visible.
WS_SIZEBOX	Creates a window that has a size box. Used only for windows with a title bar or with vertical and horizontal scroll bars.
WS_SYSMENU	Creates a window that has a window menu in its title bar. Used only for windows with title bars. If used with a child window, this style creates a close button instead of a window menu.
WS_TABSTOP	Specifies one of any number of controls through which the user can move by using the TAB key. The TAB key moves the user to the next control specified by the WS_TABSTOP style. This style is valid only for controls.
WS_THICKFRAME	Creates a window with a thick frame that can be used to size the window.
WS_VISIBLE	Creates a window that is initially visible. This applies to overlapping and pop-up windows. For overlapping windows, the y parameter is used as a parameter for the ShowWindow function.
WS_VSCROLL	Creates a window that has a vertical scroll bar.

Remarks

If the predefined names are used, you must include WINDOWS.H.