Export (0) Print
Expand All

CDialogImpl Class

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

Important note 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>

T

Your class, derived from CDialogImpl.

TBase

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

Create

Creates a modeless dialog box.

DestroyWindow

Destroys a modeless dialog box.

DoModal

Creates a modal dialog box.

EndDialog

Destroys a modal dialog box.

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.

DialogProc

Processes messages sent to the dialog box.

StartDialogProc

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

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 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

Header: atlwin.h

Show:
© 2014 Microsoft