DetailPage-MSS-KB

Microsoft small business knowledge base

Article ID: 103788 - Last Review: November 21, 2006 - Revision: 3.1

 
This article was previously published under Q103788
This article demonstrates how to create a modeless dialog box using a dialog-box template resource using MFC.

To build a CModeless dialog box, the following steps should be followed:

  1. Create a dialog class derived from CDialog and override the Create() member function of CDialog. For example, you might have code that resembles the following:
          class CModeless: public CDialog
               {
                 .
                 .
                 .
                 public:
                     CModeless(){ }
                     BOOL Create(UINT nID, CWnd * pWnd)
                          { return CDialog::Create(nID,pWnd);}
                 .
                 .
                 .
               };
    				
    NOTE: You could let ClassWizard generate the dialog class and then simply add the Create() function.
  2. Write code to construct an object of the dialog class and create the dialog box window. For example, if you have a menu item that should display the dialog box, you might have code that resembles the following:
          void CMainFrame::OnModeless()
            {
                pdlg = new CModeless;
                pdlg->Create(IDD_DIALOG1,this);
            }
    				
    where CMainFrame::pdlg is defined as:
    CModeless * pdlg;
    NOTE: It is important to allocate the object on the heap rather than the stack if you want to prevent the modeless dialog box from being destroyed when the function is exited.
  3. You must call CWnd::DestroyWindow() in OnCancel, or whenever the modeless dialog box needs to be destroyed.
          void CModeless::OnCancel()
          {
              DestroyWindow();
          }
    				
  4. Override CWnd::PostNcDestroy() in your dialog class to delete the dialog box object:
       virtual void CModeless::PostNcDestroy() {delete this;}
    				
    PostNcDestroy() is a virtual member function of the CWnd class that is called by the OnNcDestroy() function.
A modeless dialog class will typically override the OnOK() and OnCancel() member functions to call DestroyWindow() and should not call the base class CDialog::OnOK() and CDialog::OnCancel() functions. The CDialog::OnOK() and CDialog::OnCancel() functions call EndDialog(). EndDialog() should be called only when using modal dialog boxes.

If you are using Dialog Data Exchange (DDX) and Dialog Data Validation (DDV), you're OnOK() handler for your dialog class might resemble the following:
   void CModeless::OnOK()
   {
           if (!UpdateData(TRUE))
             {
               TRACE0("UpdateData failed during dialog termination\n");
               // The UpdateData routine will set focus to correct item
               return;
             }
           DestroyWindow();
   }
		

APPLIES TO
  • Microsoft Foundation Class Library 4.2, when used with:
    • Microsoft Visual C++ 1.0 Professional Edition
    • Microsoft Visual C++ 1.5 Professional Edition
    • Microsoft Visual C++ 1.51
    • Microsoft Visual C++ 1.52 Professional Edition
    • Microsoft Visual C++ 1.0 Professional Edition
    • Microsoft Visual C++ 2.0 Professional Edition
    • Microsoft Visual C++ 2.1
    • Microsoft Visual C++ 4.0 Standard Edition
Keywords: 
kbdlg kbinfo kbuidesign KB103788
Retired KB ArticleRetired KB Content Disclaimer
This article was written about products for which Microsoft no longer offers support. Therefore, this article is offered "as is" and will no longer be updated.
Share
Additional support options
Ask The Microsoft Small Business Support Community
Contact Microsoft Small Business Support
Find Microsoft Small Business Support Certified Partner
Find a Microsoft Store For In-Person Small Business Support