12. 对话框和对话框类CDialog

     

    对话框经常被使用，因为对话框可以从模板创建，而对话框模板是可以使用资源编辑器方便地进行编辑的。

     

    1. 模式和无模式对话框

        

       对话框分两种类型，模式对话框和无模式对话框。

        

       1. 模式对话框

           

          一个模式对话框是一个有系统菜单、标题栏、边线等的弹出式窗口。在创建对话框时指定WS_POPUP, WS_SYSMENU, WS_CAPTION和 DS_MODALFRAME风格。即使没有指定WS_VISIBLE风格，模式对话框也会被显示。

          创建对话框窗口时，将发送WM_INITDIALOG消息（如果指定对话框的DS_SETFONT风格，还有WM_SETFONT消息）给对话框过程。

          对话框过程(Dialog box procedure)不是对话框窗口的窗口过程(Window procedure)。在Win32里，对话框的窗口过程由Windows系统提供，用户在创建对话框窗口时提供一个对话框过程由窗口过程调用。

          对话框窗口被创建之后，Windows使得它成为一个激活的窗口，它保持激活直到对话框过程调用::EndDialog函数结束对话框的运行或者Windows激活另一个应用程序为止，在激活时，用户或者应用程序不可以激活它的所属窗口（Owner window）。

          从某个窗口创建一个模式对话框时，Windows自动地禁止使用（Disable）这个窗口和它的所有子窗口，直到该模式对话框被关闭和销毁。虽然对话框过程可以Enable所属窗口，但是这样做就失去了模式对话框的作用，所以不鼓励这样做。

          Windows创建模式对话框时，给当前捕获鼠标输入的窗口（如果有的话）发送消息WM_CANCLEMODE。收到该消息后，应用程序应该终止鼠标捕获(Release the mouse capture)以便于用户能把鼠标移到模式对话框；否则由于Owner窗口被禁止，程序将失去鼠标输入。

          为了处理模式对话框的消息，Windows开始对话框自身的消息循环，暂时控制整个应用程序的消息队列。如果Windows收到一个非对话框消息时，则它把消息派发给适当的窗口处理；如果收到了WM_QUIT消息，则把该消息放回应用程序的消息队列里，这样应用程序的主消息循环最终能处理这个消息。

          当应用程序的消息队列为空时，Windows发送WM_ENTERIDLE消息给Owner窗口。在对话框运行时，程序可以使用这个消息进行后台处理，当然应该注意经常让出控制给模式对话框，以便它能接收用户输入。如果不希望模式对话框发送WM_ENTERIDlE消息，则在创建模式对话框时指定DS_NOIDLEMSG风格。

          一个应用程序通过调用::EndDialog函数来销毁一个模式对话框。一般情况下，当用户从系统菜单里选择了关闭（Close）命令或者按下了确认（OK）或取消（CANCLE）按钮，::EndDialog被对话框过程所调用。调用::EndDialog时，指定其参数nResult的值，Windows将在销毁对话框窗口后返回这个值，一般，程序通过返回值判断对话框窗口是否完成了任务或者被用户取消。

           

       2. 无模式对话框

           

       一个无模式对话框是一个有系统菜单、标题栏、边线等的弹出式窗口。在创建对话框模板时指定WS_POPUP、WS_CAPTION、WS_BORDER和WS_SYSMENU风格。如果没有指定WS_VISIBLE风格，无模式对话框不会自动地显示出来。

       一个无模式对话框既不会禁止所属窗口，也不会给它发送消息。当创建一个模式对话框时，Windows使它成为活动窗口，但用户或者程序可以随时改变和设置活动窗口。如果对话框失去激活，那么即使所属窗口是活动的，在Z轴顺序上，它仍然在所属窗口之上。

       应用程序负责获取和派发输入消息给对话框。大部分应用程序使用主消息循环来处理，但是为了用户可以使用键盘在控制窗口之间移动或者选择控制窗口，应用程序应该调用::IsDialogMessage函数。

       这里，顺便解释::IsDialogMessage函数。虽然该函数是为无模式对话框设计的，但是任何包含了控制子窗口的窗口都可以调用它，用来实现类似于对话框的键盘选择操作。

       当::IsDialogMessage处理一个消息时，它检查键盘消息并把它们转换成相应对话框的选择命令。例如，当Tab 键被压下时，下一个或下一组控制被选中，当Down Arrow键按下后，一组控制中的下一个控制被选择。

       ::IsDialogMessage完成了所有必要的消息转换和消息派发，所以该函数处理的消息一定不要传递给TranslateMessage和DispatchMessage处理。

       一个无模式对话框不能像模式对话框那样返回一个值给应用程序。但是对话框过程可以使用::SendMessage给所属窗口传递信息。

       在应用程序结束之前，它必须销毁所有的无模式对话框。使用::DestroyWindow销毁一个无模式对话框，不是使用::EndDiaLog。一般来说，对话框过程响应用户输入，如用户选择了“取消”按钮，则调用::DestroyWindow；如果用户没有有关动作，则应用程序必须调用::DestroyWindow。

        

    2. 对话框的MFC实现

        

       在MFC中，对话框窗口的功能主要由CWnd和CDialog两个类实现。

        

       1. CDialog的设计和实现

           

          MFC通过CDialog来封装对话框的功能。CDialog从CWnd继承了窗口类的功能（包括CWnd实现的有关功能），并添加了新的成员变量和函数来处理对话框。

           

          1. CDialog的成员变量

              

             CDialog的成员变量有：

             protected:

             UINT m_nIDHelp; // Help ID (0 for none, see HID_BASE_RESOURCE)

              

             LPCTSTR m_lpszTemplateName; // name or MAKEINTRESOURCE

             HGLOBAL m_hDialogTemplate; // indirect (m_lpDialogTemplate == NULL)

             // indirect if (m_lpszTemplateName == NULL)

             LPCDLGTEMPLATE m_lpDialogTemplate;

             void* m_lpDialogInit; // DLGINIT resource data

             CWnd* m_pParentWnd; // parent/owner window

             HWND m_hWndTop; // top level parent window (may be disabled)

             成员变量保存了创建对话框的模板资源、对话框父窗口对象、顶层窗口句柄等信息。三个关于模板资源的成员变量m_lpszTemplateName、m_hDialogTemplate、m_lpDialogTemplate对应了三种模板资源，但在创建对话框时，只要一个模板资源就可以了，可以使用其中的任意一类。

              

          2. CDialog的成员函数：

              

 

1. 构造函数：

    

   CDialog( LPCTSTR lpszTemplateName, CWnd* pParentWnd = NULL );

   CDialog( UINT nIDTemplate, CWnd* pParentWnd = NULL );

   CDialog( );

   CDialog重载了三个构造函数。其中，第三个是缺省构造函数；第一个和第二个构造函数从指定的对话框模板资源创建，pParentWnd指定了父窗口或所属窗口，若空则设置父窗口为应用程序主窗口。

    

2. 初始化函数

    

   BOOL Create( LPCTSTR lpszTemplateName, CWnd* pParentWnd = NULL );

   BOOL Create( UINT nIDTemplate, CWnd* pParentWnd = NULL );

   BOOL CreateIndirect( LPCDLGTEMPLATE lpDialogTemplate, CWnd* pParentWnd = NULL );

   BOOL CreateIndirect( HGLOBAL hDialogTemplate, CWnd* pParentWnd = NULL );

   BOOL InitModalIndirect( LPCDLGTEMPLATE lpDialogTemplate, CWnd* pParentWnd = NULL );

   BOOL InitModalIndirect( HGLOBAL hDialogTemplate, CWnd* pParentWnd = NULL );

   Create用来根据模板创建无模式对话框；CreateInDirect用来根据内存中的模板创建无模式对话框；InitModalIndirect用来根据内存中的模板创建模式对话框。它们都提供了两个重载版本。

    

3. 对话框操作函数

    

   void MapDialogRect( LPRECT lpRect ) const;

   void NextDlgCtrl( ) const;

   void PrevDlgCtrl( ) const;

   void GotoDlgCtrl( CWnd* pWndCtrl );

   void SetDefID( UINT nID );

   void SetHelpID( UINT nIDR );

   void EndDialog( int nResult );

    

4. 虚拟函数

    

virtual int DoModal( );

virtual BOOL OnInitDialog( );

virtual void OnSetFont( CFont* pFont );

virtual void OnOK( );

virtual void OnCancel( );

 

1. MFC模式对话框的实现

    

   从前面的介绍可以知道，Win32 SDK编程下的模式对话框使用了Windows提供给对话框窗口的窗口过程和自己的对话框过程，对话框过程将被窗口过程调用。但在MFC下，所有的窗口类都使用了同一个窗口过程，CDialog也不例外。CDialog对象在创建Windows对话框时，采用了类似于CWnd的创建函数过程，采用子类化的手段将Windows提供给对话框的窗口过程取代为AfxWndProc或者AfxBaseWndProc，同时提供了对话框过程AfxDlgProc。那么，这些“过程”是如何实现或者协调的呢？下文将予以分析。

    

   1. MFC对话框过程

       

      MFC对话框过程AfxDlgProc的原型和实现如下：

      BOOL CALLBACK AfxDlgProc(HWND hWnd,

      UINT message, PARAM, LPARAM)

      {

      if (message == WM_INITDIALOG)

      {

      //处理WM_INITDIALOG消息

      CDialog* pDlg = DYNAMIC_DOWNCAST(CDialog,

      CWnd::FromHandlePermanent(hWnd));

      if (pDlg != NULL)

      return pDlg->OnInitDialog();

      else

      return 1;

      }

      return 0;

      }

      由上可以看出，MFC的对话框函数AfxDlgProc仅处理消息WM_INITDIALOG，其他都留给对话框窗口过程处理。因此，它不同于SDK编程的对话框过程。程序员在SDK的对话框过程处理消息和事件，实现自己的对话框功能。

      AfxDlgProc处理WM_INITDIALOG消息时调用虚拟函数OnInitDialog，给程序员一个机会处理对话框的初始化。

       

   2. 模式对话框窗口过程

       

      本小节讨论对话框的窗口过程。

      AfxWndProc是所有的MFC窗口类使用的窗口过程，它取代了模式对话框原来的窗口过程（Windows提供），那么，MFC如何完成Win32下对话框窗口的功能呢？

      考查模式对话框的创建过程。CDialog::DoModal用来创建模式对话框窗口并执行有关任务，和DoModal相关的是MFC内部使用的成员函数CDialog::PreModal和CDialog::PostModal。下面分别讨论它们的实现。

      HWND CDialog::PreModal()

      {

      // cannot call DoModal on a dialog already constructed as modeless

      ASSERT(m_hWnd == NULL);

       

      // allow OLE servers to disable themselves

      AfxGetApp()->EnableModeless(FALSE);

       

      // 得到父窗口

      CWnd* pWnd = CWnd::GetSafeOwner(m_pParentWnd, &m_hWndTop);

       

      // 如同CWnd处理其他窗口的创建，设置一个窗口创建HOOK

      AfxHookWindowCreate(this);

       

      //返回父窗口的句柄

      return pWnd->GetSafeHwnd();

      }

       

      void CDialog::PostModal()

      {

      //取消窗口创建前链接的HOOK

      AfxUnhookWindowCreate(); // just in case

      //MFC对话框对象和对应的Windows对话框窗口分离

      Detach(); // just in case

       

      // m_hWndTop是当前对话框的父窗口或所属窗口，则恢复它

      if (::IsWindow(m_hWndTop))

      ::EnableWindow(m_hWndTop, TRUE);

      m_hWndTop = NULL;

       

      AfxGetApp()->EnableModeless(TRUE);

      }

       

      int CDialog::DoModal()

      {

      // can be constructed with a resource template or InitModalIndirect

      ASSERT(m_lpszTemplateName != NULL ||

      m_hDialogTemplate != NULL || m_lpDialogTemplate != NULL);

       

      //加载对话框资源

      LPCDLGTEMPLATE lpDialogTemplate = m_lpDialogTemplate;

      HGLOBAL hDialogTemplate = m_hDialogTemplate;

      HINSTANCE hInst = AfxGetResourceHandle();

      //查找资源（见9.5.2节），找到了就加载它

      if (m_lpszTemplateName != NULL)

      {

      hInst = AfxFindResourceHandle(m_lpszTemplateName, RT_DIALOG);

      HRSRC hResource =

      ::FindResource(hInst, m_lpszTemplateName, RT_DIALOG);

      hDialogTemplate = LoadResource(hInst, hResource);

      }

       

      //锁定加载的资源

      if (hDialogTemplate != NULL)

      lpDialogTemplate = (LPCDLGTEMPLATE)LockResource(hDialogTemplate);

       

      // return -1 in case of failure to load the dialog template resource

      if (lpDialogTemplate == NULL)

      return -1;

       

      //创建对话框前禁止父窗口，为此要调用PreModal得到父窗口句柄

      HWND hWndParent = PreModal();

      AfxUnhookWindowCreate();

      CWnd* pParentWnd = CWnd::FromHandle(hWndParent);

      BOOL bEnableParent = FALSE;

      if (hWndParent != NULL && ::IsWindowEnabled(hWndParent))

      {

      ::EnableWindow(hWndParent, FALSE);

      bEnableParent = TRUE;

      }

       

      //创建对话框，注意是无模式对话框

      TRY

      {

      //链接一个HOOK到HOOK链以处理窗口创建，

      //如同4.4.1节描述的CWnd类窗口创建一样

      AfxHookWindowCreate(this);

      //CreateDlgIndirect间接调用::CreateDlgIndirect，

      //最终调用了::CreateWindowEX来创建对话框窗口。

      //HOOK过程_AfxCbtFilterHook用子类化的方法

      //取代原来的窗口过程为AfxWndProc。

      if (CreateDlgIndirect(lpDialogTemplate, CWnd::FromHandle(hWndParent), hInst))

      {

      if (m_nFlags & WF_CONTINUEMODAL)

      {

      // enter modal loop

      DWORD dwFlags = MLF_SHOWONIDLE;

      //RunModalLoop接管整个应用程序的消息处理

      if (GetStyle() & DS_NOIDLEMSG)

      dwFlags |= MLF_NOIDLEMSG;

      VERIFY(RunModalLoop(dwFlags) == m_nModalResult);

      }

       

      // hide the window before enabling the parent, etc.

      if (m_hWnd != NULL)

      SetWindowPos(NULL, 0, 0, 0, 0, SWP_HIDEWINDOW|

      SWP_NOSIZE|SWP_NOMOVE|

      SWP_NOACTIVATE|SWP_NOZORDER);

      }

      }

      CATCH_ALL(e)

      {

      DELETE_EXCEPTION(e);

      m_nModalResult = -1;

      }

      END_CATCH_ALL

       

      //Enable并且激活父窗口

      if (bEnableParent)

      ::EnableWindow(hWndParent, TRUE);

      if (hWndParent != NULL && ::GetActiveWindow() == m_hWnd)

      ::SetActiveWindow(hWndParent);

       

      //::EndDialog仅仅关闭了窗口，现在销毁窗口

      DestroyWindow();

       

      PostModal();

       

      // 必要的话，解锁/释放资源

      if (m_lpszTemplateName != NULL || m_hDialogTemplate != NULL)

      UnlockResource(hDialogTemplate);

      if (m_lpszTemplateName != NULL)

      FreeResource(hDialogTemplate);

       

      return m_nModalResult;

      }

      从DoModal的实现可以看出：

      它首先Disable对话框窗口的父窗口；然后使用::CreateIndrectDialog创建对话框窗口，使用子类化的方法用AfxWndProc（或者AfxBaseProc）替换了原来的窗口过程，并把原来的窗口过程保存在CWnd的成员变量m_pfnSuper中。原来的窗口过程就是::DialogBox等创建对话框窗口时指定的，是Windows内部提供的对话框“窗口类”的窗口过程。取代(Subclass)原来“窗口类”的窗口过程的方法如同 4.4.1节描述的CWnd::Create。

      在::CreateIndirectDialog创建对话框窗口后，会发送WM_INITDIALOG消息给对话框的对话框过程（必要的话，还有WM_SETFONT消息）。但是MFC取代了原来的对话框窗口过程，这两个消息如何送给对话框过程呢？处理方法如下节所描述。

       

   3. 使用原对话框窗口过程作消息的缺省处理

       

      对话框的消息处理过程和其他窗口并没有什么不同。这里主要分析的是如何把一些消息传递给对话框原窗口过程处理。下面，通过解释MFC对WM_INITDIALOG消息的处理来解释MFC窗口过程和原对话框窗口过程的关系及其协调作用。

      MFC提供了WM_INITDIALOG消息的处理函数CDialog::HandleInitDialog，WM_INITDIALOG消息按照标准Windows的处理送给HandleInitDialog处理。

      HandleInitDialog调用缺省处理过程Default，导致CWnd的Default函数被调用。CWnd::Default的实现如下：

      LRESULT CWnd::Default()

      {

      // call DefWindowProc with the last message

      _AFX_THREAD_STATE* pThreadState = _afxThreadState.GetData();

      return DefWindowProc(pThreadState->m_lastSentMsg.message,

      pThreadState->m_lastSentMsg.wParam,

      pThreadState->m_lastSentMsg.lParam);

      }

      顺便指出，从Default的实现可以看出线程状态的一个用途：它把本线程最新收到和处理的消息记录在成员变量m_lastSentMsg中。

      在Default的实现中，CWnd的DefWindowsProc被调用，其实现如下：

      LRESULT CWnd::DefWindowProc(UINT nMsg,

      WPARAM wParam, LPARAM lParam)

      {

      //若“窗口超类（SuperClass）”的窗口过程m_pfnSuper非空，则调用它

      if (m_pfnSuper != NULL)

      return ::CallWindowProc(m_pfnSuper, m_hWnd, nMsg, wParam, lParam);

       

      //在MFC中，GetSuperWndProcAddr的作用就是返回m_pfnSuper，为什么还

      //要再次调用呢？因为虽然该函数现在是Obsolete，但原来曾经是有用的。如

      //果返回非空，就调用该窗口过程进行处理，否则，由Windows进行缺省处理。

      WNDPROC pfnWndProc;

      if ((pfnWndProc = *GetSuperWndProcAddr()) == NULL)

      return ::DefWindowProc(m_hWnd, nMsg, wParam, lParam);

      else

      return ::CallWindowProc(pfnWndProc, m_hWnd, nMsg, wParam, lParam);

      }

      综合上述分析，HandleInitDialog最终调用了窗口过程m_pfnSuper，即Windows提供给“对话框窗口类”的窗口过程，于是该窗口过程调用了对话框过程AfxDlgProc，导致虚拟函数OnInitDialog被调用。

      顺便提一下，CWnd::AfxCallWndProc在处理WM_INITDIALOG消息之前和之后都会有一些特别的处理，如尝试把对话框放到屏幕中间。具体实现这里略。

      OnInitDialog的MFC缺省实现主要完成三件事情：

      调用ExecInitDialog初始化对话框中的控制；调用UpdateData初始化对话框控制中的数据；确定是否显示帮助按钮。所以，程序员覆盖该函数时，一定要调用基类的实现。

       

      MFC采用子类化的方法取代了对话框的窗口过程，实现了12.1节描述的模式对话框窗口的一些特性，原来SDK下对话框过程要处理的东西大部分转移给MFC窗口过程处理，如处理控制窗口的控制通知消息等。如果不能处理或者必须借助于原来的窗口过程的，则通过缺省处理函数Default传递给原来的窗口过程处理，如同这里对WM_INITDIALOG的处理一样。

       

   4. Dialog命令消息和控制通知消息的处理

       

      通过覆盖CWnd的命令消息发送函数OnCmdMsg，CDialog实现了自己的命令消息发送路径。在4.4.3.3节，曾经分析了CDialog::OnCmdMsg函数，这里给出其具体实现：

      BOOL CDialog::OnCmdMsg(UINT nID, int nCode, void* pExtra,

      AFX_CMDHANDLERINFO* pHandlerInfo)

      {

      //首先，让对话框窗口自己或者基类处理

      if (CWnd::OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))

      return TRUE;

      //如果还未处理，且是控制通知消息或者状态更新消息或者系统命令

      //则停止进一步的发送

      if ((nCode != CN_COMMAND && nCode != CN_UPDATE_COMMAND_UI) ||

      !IS_COMMAND_ID(nID) || nID >= 0xf000)

      {

      return FALSE; // not routed any further

      }

       

      //尝试给父窗口处理

      CWnd* pOwner = GetParent();

      if (pOwner != NULL)

      {

      #ifdef _DEBUG

      if (afxTraceFlags & traceCmdRouting)

      TRACE1("Routing command id 0x%04X to owner window.n", nID);

      #endif

      ASSERT(pOwner != this);

      if (pOwner->OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))

      return TRUE;

      }

       

      // 最后，给当前线程对象处理

      CWinThread* pThread = AfxGetThread();

      if (pThread != NULL)

      {

      #ifdef _DEBUG

      if (afxTraceFlags & traceCmdRouting)

      TRACE1("Routing command id 0x%04X to app.n", nID);

      #endif

      if (pThread->OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))

      return TRUE;

      }

       

      #ifdef _DEBUG

      if (afxTraceFlags & traceCmdRouting)

      {

      TRACE2("IGNORING command id 0x%04X sent to %hs dialog.n", nID,

      GetRuntimeClass()->m_lpszClassName);

      }

      #endif

      return FALSE;

      }

      从上述实现可以看出，CDialog处理命令消息遵循如下顺序：

      对话框自身→父窗口→线程对象

      例如，模式对话框产生的WM_ENTERIDLE消息就发送给父窗口处理。

      从实现中还看到，MFC根据TRACE过滤标识afxTraceFlags的值，把有关命令消息的派发显示到调试窗口。

      CDialog::OnCmdMsg不仅适用于模式对话框，也适用于无模式对话框。

       

   5. 消息预处理和Dialog消息

       

      另外，对话框窗口的消息处理还有一个特点，就是增加了对Dialog消息的处理，如同在介绍::IsDialogMessage函数时所述。如果是Dialog消息，MFC框架将不会让它进入下一步的消息循环。为此，MFC覆盖了CDialog的虚拟函数PreTranslateMessage，该函数的实现如下：

      BOOL CDialog::PreTranslateMessage(MSG* pMsg)

      {

      // 用于无模式或者模式对话框的处理

      ASSERT(m_hWnd != NULL);

       

      //过滤tooltip messages

      if (CWnd::PreTranslateMessage(pMsg))

      return TRUE;

       

      //在Shift+F1帮助模式下，不转换Dialog messages

      CFrameWnd* pFrameWnd = GetTopLevelFrame();

      if (pFrameWnd != NULL && pFrameWnd->m_bHelpMode)

      return FALSE;

       

      //处理Escape键按下的消息

      if (pMsg->message == WM_KEYDOWN &&

      (pMsg->wParam == VK_ESCAPE || pMsg->wParam == VK_CANCEL) &&

      (::GetWindowLong(pMsg->hwnd, GWL_STYLE) & ES_MULTILINE) &&

      _AfxCompareClassName(pMsg->hwnd, _T("Edit")))

      {

      HWND hItem = ::GetDlgItem(m_hWnd, IDCANCEL);

      if (hItem == NULL || ::IsWindowEnabled(hItem))

      {

      SendMessage(WM_COMMAND, IDCANCEL, 0);

      return TRUE;

      }

      }

      // 过滤来自控制该对话框子窗口的送给该对话框的Dialog消息

      return PreTranslateInput(pMsg);

      }

      从其实现可以看出，如果是Tooltip消息或者Dialog消息，这些消息将在PreTranslateMessage中被处理，不会进入消息发送的处理。

      PreTranslateInput是CWnd的成员函数，它调用::IsDialogMessage函数来处理Dialog消息。

      PreTranslateMessage的实现不仅用于模式对话框，而且用于无模式对话框。

       

   6. 模式对话框的消息循环

       

   从DoModal的实现可以看出，DoModal调用CreateDlgIndirect创建的是无模式对话框，MFC如何来接管和控制应用程序的消息队列，实现一个模式对话框的功能呢？

   CDialog调用了RunModalLoop来实现模式窗口的消息循环。RunModalLoop是CWnd的成员函数，它和相关函数的实现如下：

   int CWnd::RunModalLoop(DWORD dwFlags)

   {

   ASSERT(::IsWindow(m_hWnd)); //窗口必须已经创建且不在模式状态 ASSERT(!(m_nFlags & WF_MODALLOOP));

    

   // 以下变量用于Idle处理

   BOOL bIdle = TRUE;

   LONG lIdleCount = 0;

   BOOL bShowIdle = (dwFlags & MLF_SHOWONIDLE) &&

   !(GetStyle() & WS_VISIBLE);

   HWND hWndParent = ::GetParent(m_hWnd);

   m_nFlags |= (WF_MODALLOOP|WF_CONTINUEMODAL);

   MSG* pMsg = &AfxGetThread()->m_msgCur;

    

   //获取和派发消息直到模式状态结束

   for (;;)

   {

   ASSERT(ContinueModal());

    

   //第一阶段，判断是否可以进行Idle处理

   while (bIdle &&!::PeekMessage(pMsg, NULL, NULL, NULL, PM_NOREMOVE))

   {

   ASSERT(ContinueModal());

    

   //必要的话，当Idle时显示对话框窗口

   if (bShowIdle)

   {

   ShowWindow(SW_SHOWNORMAL);

   UpdateWindow();

   bShowIdle = FALSE;

   }

    

   // 进行Idle处理

   //必要的话发送WM_ENTERIDLE消息给父窗口

   if (!(dwFlags & MLF_NOIDLEMSG) &&hWndParent != NULL && lIdleCount == 0)

   {

   ::SendMessage(hWndParent, WM_ENTERIDLE,

   MSGF_DIALOGBOX, (LPARAM)m_hWnd);

   }

   //必要的话发送WM_KICKIDLE消息给父窗口

   if ((dwFlags & MLF_NOKICKIDLE) ||

   !SendMessage(WM_KICKIDLE, MSGF_DIALOGBOX, lIdleCount++))

   {

   //终止Idle处理

   bIdle = FALSE;

   }

   }

    

   //第二阶段，发送消息

   do

   {

   ASSERT(ContinueModal());

    

   // 若是WM_QUIT消息，则发送该消息到消息队列，返回；否则发送消息。

   if (!AfxGetThread()->PumpMessage())

   {

   AfxPostQuitMessage(0);

   return -1;

   }

    

   //必要的话，显示对话框窗口

   if (bShowIdle &&

   (pMsg->message == 0x118 || pMsg->message == WM_SYSKEYDOWN))

   {

   ShowWindow(SW_SHOWNORMAL);

   UpdateWindow();

   bShowIdle = FALSE;

   }

    

   if (!ContinueModal())

   goto ExitModal;

    

   //在派发了“正常 ”消息后，重新开始Idle处理

   if (AfxGetThread()->IsIdleMessage(pMsg))

   {

   bIdle = TRUE;

   lIdleCount = 0;

   }

   } while (::PeekMessage(pMsg, NULL, NULL, NULL, PM_NOREMOVE));

   }

    

   ExitModal:

   m_nFlags &= ~(WF_MODALLOOP|WF_CONTINUEMODAL);

   return m_nModalResult;

   }

    

   BOOL CWnd::ContinueModal()

   {

   return m_nFlags & WF_CONTINUEMODAL;

   }

    

   void CWnd::EndModalLoop(int nResult)

   {

   ASSERT(::IsWindow(m_hWnd));

    

   // this result will be returned from CWnd::RunModalLoop

   m_nModalResult = nResult;

    

   // make sure a message goes through to exit the modal loop

   if (m_nFlags & WF_CONTINUEMODAL)

   {

   m_nFlags &= ~WF_CONTINUEMODAL;

   PostMessage(WM_NULL);

   }

   }

   和CWinThread::Run的处理过程比较，RunModalLoop也分两个阶段进行处理。不同之处在于，这里不同于Run的Idle处理，RunModalLoop是给父窗口发送WM_ENTERIDLE消息（如果需要的话）；另外，当前对话框的父窗口被Disabled，是不接收用户消息的。

   RunModalLoop是一个实现自己的消息循环的示例，消息循环的条件是模式化状态没有结束。实现线程自己的消息循环见8.5.6节。

   当用户按下按钮“取消”、“确定”时，将导致RunModalLoop退出消息循环，结束对话框模式状态，并调用::EndDialog关闭窗口。有关关闭对话框的处理如下：

   void CDialog::EndDialog(int nResult)

   {

   ASSERT(::IsWindow(m_hWnd));

    

   if (m_nFlags & (WF_MODALLOOP|WF_CONTINUEMODAL))

   EndModalLoop(nResult);

    

   ::EndDialog(m_hWnd, nResult);

   }

   void CDialog::OnOK()

   {

   if (!UpdateData(TRUE)) {

   TRACE0("UpdateData failed during dialog termination.n");

   // the UpdateData routine will set focus to correct item

   return;

   }

   EndDialog(IDOK);

   }

    

   void CDialog::OnCancel()

   {

   EndDialog(IDCANCEL);

   }

   上述函数OnOk、OnCancle、EndDialog都可以用来关闭对话框窗口。其中：

   OnOk首先进行数据交换，获取对话框中各个控制子窗口的数据，然后调用EndDialog结束对话框。

   OnCancle直接EndDialog结束对话框。

   EndDialog首先修改m_nFlag的值，表示结束模式循环，然后调用::EndDialog关闭对话框窗口。

    

2. 对话框的数据交换

    

   对话框数据交换指以下两种动作，或者是把内存数据写入对应的控制窗口，或者是从控制窗口读取数据并保存到内存变量中。MFC为了简化这些操作，以CDataExchange类和一些数据交换函数为基础，提供了一套数据交换和校验的机制。

    

   1. 数据交换的方法

       

      首先，定义保存数据的内存变量──给对话框添加成员变量，每个控制窗口可以对应一个成员变量，或者是控制窗口类型，或者是控制窗口表示的数据的类型。例如，对于对话框的一个编辑控制窗口，可以定义一个CEdit类型的成员变量，或者一个CString类型的成员变量。

      其次，覆盖对话框的虚拟函数DoDataExchange，实现数据交换和验证。

      ClassWizard可以协助程序员自动地添加成员变量，修改DoDataExchange。例如，一个对话框有两个控制窗口，其中的一个编辑框表示姓名，ID是IDC_NAME，另一个编辑框表示年龄，ID是IDC_AGE，ClassWizard添加如下的成员变量：

      // Dialog Data

      //{{AFX_DATA(CExDialog)

      enum { IDD = IDD_DIALOG2 };

      CEdit m_name;

      int m_iAge;

      //}}AFX_DATA

      使用ClassWizard添加成员变量中，一个定义为CEdit，另一个定义为int。这些定义被“//{{AFX_DATA”和“//}}AFX_DATA”引用，表示是ClassWizard添加的，程序员不必修改它们。

      相应的DoDataExchange的实现如下：

      void CExDialog::DoDataExchange(CDataExchange* pDX)

      {

      CDialog::DoDataExchange(pDX);

      //{{AFX_DATA_MAP(CFtpDialog)

      DDX_Control(pDX, IDC_NAME, m_name);

      DDX_Text(pDX, IDC_AGE, m_nAge);

      DDV_MinMaxInt(pDX, m_nAge, 1, 100);

      //}}AFX_DATA_MAP

      }

      DDX_ Control表示把IDC_NAME子窗口的内容传输到窗口m_name，或者相反。

      DDX_ Text表示把IDC_AGE子窗口的内容按整数类型保存到m_nAge，或者相反。

      DDV_MinMaxInt表示m_nAge应该在1和100之间取值。

       

   2. CDataExchange

       

      上文中提到DDX_Xxxxx数据交换函数可以进行双向的数据交换，那么它们如何知道数据传输的方向呢？这通过DDX_Xxxxx函数的第一个参数pDX（也就是DoDataEx change的参数pDX）所指的CDataExchange对象来决定，pDX指向一个CdataExchange对象。CDataExchange定义如下：

      class CDataExchange

      {

      // Attributes

      public:

      BOOL m_bSaveAndValidate; // TRUE 则 保存和验证数据

      CWnd* m_pDlgWnd; // 指向一个对话框

       

      // Operations (for implementors of DDX and DDV procs)

      HWND PrepareCtrl(int nIDC); //返回指定ID的控制窗口的句柄

      HWND PrepareEditCtrl(int nIDC); //返回指定ID的编辑控制窗口句柄

      void Fail(); // 用来扔出例外

       

      #ifndef _AFX_NO_OCC_SUPPORT //OLE控制

      CWnd* PrepareOleCtrl(int nIDC); // 用于对话框中的OLE控制窗口

      #endif

       

      // Implementation

      CDataExchange(CWnd* pDlgWnd, BOOL bSaveAndValidate);

       

      HWND m_hWndLastControl; // last control used (for validation)

      BOOL m_bEditLastControl; // last control was an edit item

      };

      DoDataExchange类似于Serialize函数，CDataExchange类似于CArchive。CDataExchange使用成员变量m_pDlgWnd保存要进行数据交换的对话框，使用成员变量m_bSaveAndValidate指示数据传输的方向，如果该变量真，则从控制窗口读取数据到成员变量，如果假，则从成员变量写数据到控制窗口。

      在构造一个CDataExchange对象时，将保存有关信息在对象的成员变量中。构造函数如下：

      CDataExchange::CDataExchange(CWnd* pDlgWnd, BOOL bSaveAndValidate)

      {

      ASSERT_VALID(pDlgWnd);

      m_bSaveAndValidate = bSaveAndValidate;

      m_pDlgWnd = pDlgWnd;

      m_hWndLastControl = NULL;

      }

      构造函数参数指定了进行数据交换的对话框pDlgWnd和数据传输方向bSaveAndValidate。

       

   3. 数据交换和验证函数

       

在进行数据交换或者验证时，首先使用PrePareCtrl或者PrePareEditCtrl得到控制窗口的句柄，然后使用::GetWindowsText从控制窗口读取数据，或者使用::SetWindowsText写入数据到控制窗口。下面讨论几个例子：

 

• static void AFX_CDECL DDX_TextWithFormat(CDataExchange* pDX,

   

{

va_list pData; //用来处理个数可以变化的参数

va_start(pData, nIDPrompt);//得到参数

//得到编辑框的句柄

HWND hWndCtrl = pDX->PrepareEditCtrl(nIDC);

TCHAR szT[32];

if (pDX->m_bSaveAndValidate) //TRUE，从编辑框读出数据

{

}

else //FALSE，写入数据到编辑框

{

//把要写的内容转换成指定格式

}

va_end(pData);//结束参数分析

}