Dialog box properties

Button

Style

Effect

Tool window

WS_EX_TOOLWINDOW

A tool window has a title bar that is shorter than a normal title bar, and the window title is drawn using a smaller font. A tool window does not appear in the task bar or in the window that appears when the user presses ALT+TAB.

Accept files

WS_EX_ACCEPTFILES

Specifies that a window created with this style accepts drag-and-drop files.

Clip siblings

WS_CLIPSIBLINGS

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

Transparent

WS_EX_TRANSPARENT

Specifies that a window created with this style is to be transparent. That is, any windows that are beneath the window are not obscured by the window. A window created with this style receives WM_PAINT messages only after all sibling windows beneath it have been updated.

Center mouse

DS_CENTERMOUSE

Centers the mouse cursor in the dialog box.

Set foreground

DS_SETFOREGROUND

This style brings the dialog box to the foreground. Internally, Windows calls the SetForegroundWindow function for the dialog box.

Control

DS_CONTROL

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.

Absolute alignment

DS_ABSALIGN

Indicates that the coordinates of the dialog box are screen coordinates ; otherwise, Windows assumes they are client coordinates.

No idle msg.

DS_NOIDLEMSG

Suppresses WM_ENTERIDLE messages that Windows would otherwise send to the owner of the dialog box while the dialog box is displayed.

System modal

DS_SYSMODAL

Creates a system-modal dialog box. This style causes the dialog box to have the WS_EX_TOPMOST style, but otherwise has no effect on the dialog box or the behavior of other windows in the system when the dialog box is displayed.

Popup

WS_POPUP

Creates a dialog that has the WS_POPUP bit on. Normally this is the default.

Child

WS_CHILD

Creates a dialog that has the WS_CHILD window style. Normally this is not desired. The dialog box can’t leave the boundaries of its mother window.

No fail create

DS_NOFAILCREATE

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.

Clip children

WS_CLIPCHILDREN

Avoids drawing in child windows

Local edit

DS_LOCALEDIT

Applies to 16-bit applications only. This style directs edit controls in the dialog box to allocate memory from the application’s data segment. Otherwise, edit controls allocate storage from a global memory object. Somehow this button has resisted the port from 16 bit weditres...

3D look

DS_3DLOOK

This style is required only by Win32-based applications compiled for versions of Windows earlier than Windows 95 or Windows NT 4.0. The system automatically applies the three-dimensional look to dialog boxes created by applications compiled for current versions of Windows.

Center

DS_CENTER

Centers the dialog box in the working area ; that is, the area not obscured by the tray.

Visible

WS_VISIBLE

Show the dialog when it starts

Context help

DS_CONTEXTHELP

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 should pass the message to the dialog procedure, which should call the WinHelp function using the HELP_WM_HELP command. The Help application displays a pop-up window that typically contains help for the control.Note that DS_CONTEXTHELP is just 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.

Disabled

WS_DISABLED

Creates a window that is disabled at startup.

 

Optional Gadgets

Button

Style

Effect

Title

WS_CAPTION

Shows a dialog box title

Min button

WS_MINIMIZE

Minimize control in titlebar

Max button

WS_MAXIMIZE

Maximize button in titlebar

System menu

WS_SYSMENU

System menu

Vertical/horizontal scroll

WS_HSCROLL/WS_VSCROLL

Scroll bars. Normally never used

Standard buttons

This allows you to add the standard button ‘OK’, ‘Cancel’, and ‘Help’ to the dialog box automatically.

Just press the ones you want to be added.