CDialogImpl Class

This class provides methods for creating a modal or modeless dialog box.

Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

template < 
class T, 
class TBase= CWindow  
> 
class ATL_NO_VTABLE CDialogImpl : 
public CDialogImplBaseT< TBase>

Parameters

• T
  Your class, derived from CDialogImpl.

• TBase
  The base class of your new class. The default base class is CWindow.

Members

Methods

Create	Creates a modeless dialog box.
DestroyWindow	Destroys a modeless dialog box.
DoModal	Creates a modal dialog box.
EndDialog	Destroys a modal dialog box.

CDialogImplBaseT Methods

GetDialogProc	Returns the current dialog box procedure.
MapDialogRect	Maps the dialog-box units of the specified rectangle to screen units (pixels).
OnFinalMessage	Called after receiving the last message, typically WM_NCDESTROY.

Static Functions

DialogProc	Processes messages sent to the dialog box.
StartDialogProc	Called when the first message is received to process messages sent to the dialog box.

Remarks

With CDialogImpl you can create a modal or modeless dialog box. CDialogImpl provides the dialog box procedure, which uses the default message map to direct messages to the appropriate handlers.

The base class destructor ~CWindowImplRoot ensures that the window is gone before destroying the object.

CDialogImpl derives from CDialogImplBaseT, which in turn derives from CWindowImplRoot.

Note

Your class must define an IDD member that specifies the dialog template resource ID. For example, the ATL Project Wizard automatically adds the following line to your class:

enum { IDD = IDD_MYDLG };

where MyDlg is the Short name entered in the wizard's Names page.

For more information about	See
Creating controls	ATL Tutorial
Using dialog boxes in ATL	ATL Window Classes
ATL Project Wizard	Creating an ATL Project
Dialog boxes	Dialog Boxes and subsequent topics in the Windows SDK

Requirements

Header: atlwin.h

See Also

Reference

BEGIN_MSG_MAP

Other Resources

ATL Class Overview