對話框經常被使用,因為對話框可以從模板創建,而對話框模板是可以使用資源編輯器方便地進行編輯的。
模式和無模式對話框
對話框分兩種類型,模式對話框和無模式對話框。
模式對話框
一個模式對話框是一個有系統菜單、標題欄、邊線等的彈出式窗口。在創建對話框時指定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將在銷毀對話框窗口後返回這個值,一般,程序通過返回值判斷對話框窗口是否完成了任務或者被用戶取消。
無模式對話框
一個無模式對話框是一個有系統菜單、標題欄、邊線等的彈出式窗口。在創建對話框模板時指定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。
對話框的MFC實現
在MFC中,對話框窗口的功能主要由CWnd和CDialog兩個類實現。
CDialog的設計和實現
MFC通過CDialog來封裝對話框的功能。CDialog從CWnd繼承了窗口類的功能(包括CWnd實現的有關功能),並添加了新的成員變量和函數來處理對話框。
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對應了三種模板資源,但在創建對話框時,只要一個模板資源就可以了,可以使用其中的任意一類。
CDialog的成員函數:
構造函數:
CDialog( LPCTSTR lpszTemplateName, CWnd* pParentWnd = NULL );
CDialog( UINT nIDTemplate, CWnd* pParentWnd = NULL );
CDialog( );
CDialog重載了三個構造函數。其中,第三個是缺省構造函數;第一個和第二個構造函數從指定的對話框模板資源創建,pParentWnd指定了父窗口或所屬窗口,若空則設置父窗口為應用程序主窗口。---www.bianceng.cn
初始化函數
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用來根據內存中的模板創建模式對話框。它們都提供了兩個重載版本。
對話框操作函數
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 );
虛擬函數
virtual int DoModal( );
virtual BOOL OnInitDialog( );
virtual void OnSetFont( CFont* pFont );
virtual void OnOK( );
virtual void OnCancel( );
MFC模式對話框的實現
從前面的介紹可以知道,Win32 SDK編程下的模式對話框使用了Windows提供給對話框窗口的窗口過程和自己的對話框過程,對話框過程將被窗口過程調用。但在MFC下,所有的窗口類都使用了同一個窗口過程,CDialog也不例外。CDialog對象在創建Windows對話框時,采用了類似於CWnd的創建函數過程,采用子類化的手段將Windows提供給對話框的窗口過程取代為AfxWndProc或者AfxBaseWndProc,同時提供了對話框過程AfxDlgProc。那麼,這些“過程”是如何實現或者協調的呢?下文將予以分析。
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,給程序員一個機會處理對話框的初始化。
模式對話框窗口過程
本小節討論對話框的窗口過程。
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取代了原來的對話框窗口過程,這兩個消息如何送給對話框過程呢?處理方法如下節所描述。
使用原對話框窗口過程作消息的缺省處理
對話框的消息處理過程和其他窗口並沒有什麼不同。這裡主要分析的是如何把一些消息傳遞給對話框原窗口過程處理。下面,通過解釋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的處理一樣。
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.
", 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.
", 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.
", nID,
GetRuntimeClass()->m_lpszClassName);
}
#endif
return FALSE;
}
從上述實現可以看出,CDialog處理命令消息遵循如下順序:
對話框自身→父窗口→線程對象
例如,模式對話框產生的WM_ENTERIDLE消息就發送給父窗口處理。
從實現中還看到,MFC根據TRACE過濾標識afxTraceFlags的值,把有關命令消息的派發顯示到調試窗口。
CDialog::OnCmdMsg不僅適用於模式對話框,也適用於無模式對話框。
消息預處理和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的實現不僅用於模式對話框,而且用於無模式對話框。
模式對話框的消息循環
從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,是不接收用戶消息的。