Partager via


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