CSimpleDialog Class

This class implements a basic modal dialog box.

Syntax

template <WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE>
class CSimpleDialog : public CDialogImplBase

Parameters

t_wDlgTemplateID

The resource ID of the dialog template resource.

t_bCenter
TRUE if the dialog object is to be centered on the owner window; otherwise FALSE.

Members

Public Methods

Name Description
CSimpleDialog::DoModal Creates a modal dialog box.

Remarks

Implements a modal dialog box with basic functionality. CSimpleDialog provides support for Windows common controls only. To create and display a modal dialog box, create an instance of this class, providing the name of an existing resource template for the dialog box. The dialog box object closes when the user clicks any control with a pre-defined value (such as IDOK or IDCANCEL).

CSimpleDialog allows you to create only modal dialog boxes. CSimpleDialog provides the dialog box procedure, which uses the default message map to direct messages to the appropriate handlers.

See Implementing a Dialog Box for more information.

Inheritance Hierarchy

CDialogImplBase

CSimpleDialog

Requirements

Header: atlwin.h

CSimpleDialog::DoModal

Invokes a modal dialog box and returns the dialog-box result when done.

INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());

Parameters

hWndParent
A handle to the parent of the dialog box. If no value is provided, the parent is set to the current active window.

Return Value

If successful, the return value is the resource ID of the control that dismissed the dialog box.

If the function fails, the return value is -1. To get extended error information, call GetLastError.

Remarks

This method handles all interaction with the user while the dialog box is active. This is what makes the dialog box modal; that is, the user cannot interact with other windows until the dialog box is closed.

See also

Class Overview