對(duì)話框經(jīng)常被使用,因?yàn)閷?duì)話框可以從模板創(chuàng)建,而對(duì)話框模板是可以使用資源編輯器方便地進(jìn)行編輯的。
對(duì)話框分兩種類型,模式對(duì)話框和無模式對(duì)話框。
一個(gè)模式對(duì)話框是一個(gè)有系統(tǒng)菜單、標(biāo)題欄、邊線等的彈出式窗口。在創(chuàng)建對(duì)話框時(shí)指定WS_POPUP, WS_SYSMENU, WS_CAPTION和 DS_MODALFRAME風(fēng)格。即使沒有指定WS_VISIBLE風(fēng)格,模式對(duì)話框也會(huì)被顯示。
創(chuàng)建對(duì)話框窗口時(shí),將發(fā)送WM_INITDIALOG消息(如果指定對(duì)話框的DS_SETFONT風(fēng)格,還有WM_SETFONT消息)給對(duì)話框過程。
對(duì)話框過程(Dialog box procedure)不是對(duì)話框窗口的窗口過程(Window procedure)。在Win32里,對(duì)話框的窗口過程由Windows系統(tǒng)提供,用戶在創(chuàng)建對(duì)話框窗口時(shí)提供一個(gè)對(duì)話框過程由窗口過程調(diào)用。
對(duì)話框窗口被創(chuàng)建之后,Windows使得它成為一個(gè)激活的窗口,它保持激活直到對(duì)話框過程調(diào)用::EndDialog函數(shù)結(jié)束對(duì)話框的運(yùn)行或者Windows激活另一個(gè)應(yīng)用程序?yàn)橹梗诩せ顣r(shí),用戶或者應(yīng)用程序不可以激活它的所屬窗口(Owner window)。
從某個(gè)窗口創(chuàng)建一個(gè)模式對(duì)話框時(shí),Windows自動(dòng)地禁止使用(Disable)這個(gè)窗口和它的所有子窗口,直到該模式對(duì)話框被關(guān)閉和銷毀。雖然對(duì)話框過程可以Enable所屬窗口,但是這樣做就失去了模式對(duì)話框的作用,所以不鼓勵(lì)這樣做。
Windows創(chuàng)建模式對(duì)話框時(shí),給當(dāng)前捕獲鼠標(biāo)輸入的窗口(如果有的話)發(fā)送消息WM_CANCLEMODE。收到該消息后,應(yīng)用程序應(yīng)該終止鼠標(biāo)捕獲(Release the mouse capture)以便于用戶能把鼠標(biāo)移到模式對(duì)話框;否則由于Owner窗口被禁止,程序?qū)⑹ナ髽?biāo)輸入。
為了處理模式對(duì)話框的消息,Windows開始對(duì)話框自身的消息循環(huán),暫時(shí)控制整個(gè)應(yīng)用程序的消息隊(duì)列。如果Windows收到一個(gè)非對(duì)話框消息時(shí),則它把消息派發(fā)給適當(dāng)?shù)拇翱谔幚?;如果收到了WM_QUIT消息,則把該消息放回應(yīng)用程序的消息隊(duì)列里,這樣應(yīng)用程序的主消息循環(huán)最終能處理這個(gè)消息。
當(dāng)應(yīng)用程序的消息隊(duì)列為空時(shí),Windows發(fā)送WM_ENTERIDLE消息給Owner窗口。在對(duì)話框運(yùn)行時(shí),程序可以使用這個(gè)消息進(jìn)行后臺(tái)處理,當(dāng)然應(yīng)該注意經(jīng)常讓出控制給模式對(duì)話框,以便它能接收用戶輸入。如果不希望模式對(duì)話框發(fā)送WM_ENTERIDlE消息,則在創(chuàng)建模式對(duì)話框時(shí)指定DS_NOIDLEMSG風(fēng)格。
一個(gè)應(yīng)用程序通過調(diào)用::EndDialog函數(shù)來銷毀一個(gè)模式對(duì)話框。一般情況下,當(dāng)用戶從系統(tǒng)菜單里選擇了關(guān)閉(Close)命令或者按下了確認(rèn)(OK)或取消(CANCLE)按鈕,::EndDialog被對(duì)話框過程所調(diào)用。調(diào)用::EndDialog時(shí),指定其參數(shù)nResult的值,Windows將在銷毀對(duì)話框窗口后返回這個(gè)值,一般,程序通過返回值判斷對(duì)話框窗口是否完成了任務(wù)或者被用戶取消。
一個(gè)無模式對(duì)話框是一個(gè)有系統(tǒng)菜單、標(biāo)題欄、邊線等的彈出式窗口。在創(chuàng)建對(duì)話框模板時(shí)指定WS_POPUP、WS_CAPTION、WS_BORDER和WS_SYSMENU風(fēng)格。如果沒有指定WS_VISIBLE風(fēng)格,無模式對(duì)話框不會(huì)自動(dòng)地顯示出來。
一個(gè)無模式對(duì)話框既不會(huì)禁止所屬窗口,也不會(huì)給它發(fā)送消息。當(dāng)創(chuàng)建一個(gè)模式對(duì)話框時(shí),Windows使它成為活動(dòng)窗口,但用戶或者程序可以隨時(shí)改變和設(shè)置活動(dòng)窗口。如果對(duì)話框失去激活,那么即使所屬窗口是活動(dòng)的,在Z軸順序上,它仍然在所屬窗口之上。
應(yīng)用程序負(fù)責(zé)獲取和派發(fā)輸入消息給對(duì)話框。大部分應(yīng)用程序使用主消息循環(huán)來處理,但是為了用戶可以使用鍵盤在控制窗口之間移動(dòng)或者選擇控制窗口,應(yīng)用程序應(yīng)該調(diào)用::IsDialogMessage函數(shù)。
這里,順便解釋::IsDialogMessage函數(shù)。雖然該函數(shù)是為無模式對(duì)話框設(shè)計(jì)的,但是任何包含了控制子窗口的窗口都可以調(diào)用它,用來實(shí)現(xiàn)類似于對(duì)話框的鍵盤選擇操作。
當(dāng)::IsDialogMessage處理一個(gè)消息時(shí),它檢查鍵盤消息并把它們轉(zhuǎn)換成相應(yīng)對(duì)話框的選擇命令。例如,當(dāng)Tab 鍵被壓下時(shí),下一個(gè)或下一組控制被選中,當(dāng)Down Arrow鍵按下后,一組控制中的下一個(gè)控制被選擇。
::IsDialogMessage完成了所有必要的消息轉(zhuǎn)換和消息派發(fā),所以該函數(shù)處理的消息一定不要傳遞給TranslateMessage和DispatchMessage處理。
一個(gè)無模式對(duì)話框不能像模式對(duì)話框那樣返回一個(gè)值給應(yīng)用程序。但是對(duì)話框過程可以使用::SendMessage給所屬窗口傳遞信息。
在應(yīng)用程序結(jié)束之前,它必須銷毀所有的無模式對(duì)話框。使用::DestroyWindow銷毀一個(gè)無模式對(duì)話框,不是使用::EndDiaLog。一般來說,對(duì)話框過程響應(yīng)用戶輸入,如用戶選擇了“取消”按鈕,則調(diào)用::DestroyWindow;如果用戶沒有有關(guān)動(dòng)作,則應(yīng)用程序必須調(diào)用::DestroyWindow。
在MFC中,對(duì)話框窗口的功能主要由CWnd和CDialog兩個(gè)類實(shí)現(xiàn)。
MFC通過CDialog來封裝對(duì)話框的功能。CDialog從CWnd繼承了窗口類的功能(包括CWnd實(shí)現(xiàn)的有關(guān)功能),并添加了新的成員變量和函數(shù)來處理對(duì)話框。
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)
成員變量保存了創(chuàng)建對(duì)話框的模板資源、對(duì)話框父窗口對(duì)象、頂層窗口句柄等信息。三個(gè)關(guān)于模板資源的成員變量m_lpszTemplateName、m_hDialogTemplate、m_lpDialogTemplate對(duì)應(yīng)了三種模板資源,但在創(chuàng)建對(duì)話框時(shí),只要一個(gè)模板資源就可以了,可以使用其中的任意一類。
CDialog( LPCTSTR lpszTemplateName, CWnd* pParentWnd = NULL );
CDialog( UINT nIDTemplate, CWnd* pParentWnd = NULL );
CDialog( );
CDialog重載了三個(gè)構(gòu)造函數(shù)。其中,第三個(gè)是缺省構(gòu)造函數(shù);第一個(gè)和第二個(gè)構(gòu)造函數(shù)從指定的對(duì)話框模板資源創(chuàng)建,pParentWnd指定了父窗口或所屬窗口,若空則設(shè)置父窗口為應(yīng)用程序主窗口。
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用來根據(jù)模板創(chuàng)建無模式對(duì)話框;CreateInDirect用來根據(jù)內(nèi)存中的模板創(chuàng)建無模式對(duì)話框;InitModalIndirect用來根據(jù)內(nèi)存中的模板創(chuàng)建模式對(duì)話框。它們都提供了兩個(gè)重載版本。
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( );
從前面的介紹可以知道,Win32 SDK編程下的模式對(duì)話框使用了Windows提供給對(duì)話框窗口的窗口過程和自己的對(duì)話框過程,對(duì)話框過程將被窗口過程調(diào)用。但在MFC下,所有的窗口類都使用了同一個(gè)窗口過程,CDialog也不例外。CDialog對(duì)象在創(chuàng)建Windows對(duì)話框時(shí),采用了類似于CWnd的創(chuàng)建函數(shù)過程,采用子類化的手段將Windows提供給對(duì)話框的窗口過程取代為AfxWndProc或者AfxBaseWndProc,同時(shí)提供了對(duì)話框過程AfxDlgProc。那么,這些“過程”是如何實(shí)現(xiàn)或者協(xié)調(diào)的呢?下文將予以分析。
MFC對(duì)話框過程AfxDlgProc的原型和實(shí)現(xiàn)如下:
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的對(duì)話框函數(shù)AfxDlgProc僅處理消息WM_INITDIALOG,其他都留給對(duì)話框窗口過程處理。因此,它不同于SDK編程的對(duì)話框過程。程序員在SDK的對(duì)話框過程處理消息和事件,實(shí)現(xiàn)自己的對(duì)話框功能。
AfxDlgProc處理WM_INITDIALOG消息時(shí)調(diào)用虛擬函數(shù)OnInitDialog,給程序員一個(gè)機(jī)會(huì)處理對(duì)話框的初始化。
本小節(jié)討論對(duì)話框的窗口過程。
AfxWndProc是所有的MFC窗口類使用的窗口過程,它取代了模式對(duì)話框原來的窗口過程(Windows提供),那么,MFC如何完成Win32下對(duì)話框窗口的功能呢?
考查模式對(duì)話框的創(chuàng)建過程。CDialog::DoModal用來創(chuàng)建模式對(duì)話框窗口并執(zhí)行有關(guān)任務(wù),和DoModal相關(guān)的是MFC內(nèi)部使用的成員函數(shù)CDialog::PreModal和CDialog::PostModal。下面分別討論它們的實(shí)現(xiàn)。
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處理其他窗口的創(chuàng)建,設(shè)置一個(gè)窗口創(chuàng)建HOOK
AfxHookWindowCreate(this);
//返回父窗口的句柄
return pWnd->GetSafeHwnd();
}
void CDialog::PostModal()
{
//取消窗口創(chuàng)建前鏈接的HOOK
AfxUnhookWindowCreate(); // just in case
//MFC對(duì)話框?qū)ο蠛蛯?duì)應(yīng)的Windows對(duì)話框窗口分離
Detach(); // just in case
// m_hWndTop是當(dāng)前對(duì)話框的父窗口或所屬窗口,則恢復(fù)它
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);
//加載對(duì)話框資源
LPCDLGTEMPLATE lpDialogTemplate = m_lpDialogTemplate;
HGLOBAL hDialogTemplate = m_hDialogTemplate;
HINSTANCE hInst = AfxGetResourceHandle();
//查找資源(見9.5.2節(jié)),找到了就加載它
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;
//創(chuàng)建對(duì)話框前禁止父窗口,為此要調(diào)用PreModal得到父窗口句柄
HWND hWndParent = PreModal();
AfxUnhookWindowCreate();
CWnd* pParentWnd = CWnd::FromHandle(hWndParent);
BOOL bEnableParent = FALSE;
if (hWndParent != NULL && ::IsWindowEnabled(hWndParent))
{
::EnableWindow(hWndParent, FALSE);
bEnableParent = TRUE;
}
//創(chuàng)建對(duì)話框,注意是無模式對(duì)話框
TRY
{
//鏈接一個(gè)HOOK到HOOK鏈以處理窗口創(chuàng)建,
//如同4.4.1節(jié)描述的CWnd類窗口創(chuàng)建一樣
AfxHookWindowCreate(this);
//CreateDlgIndirect間接調(diào)用::CreateDlgIndirect,
//最終調(diào)用了::CreateWindowEX來創(chuàng)建對(duì)話框窗口。
//HOOK過程_AfxCbtFilterHook用子類化的方法
//取代原來的窗口過程為AfxWndProc。
if (CreateDlgIndirect(lpDialogTemplate, CWnd::FromHandle(hWndParent), hInst))
{
if (m_nFlags & WF_CONTINUEMODAL)
{
// enter modal loop
DWORD dwFlags = MLF_SHOWONIDLE;
//RunModalLoop接管整個(gè)應(yīng)用程序的消息處理
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僅僅關(guān)閉了窗口,現(xiàn)在銷毀窗口
DestroyWindow();
PostModal();
// 必要的話,解鎖/釋放資源
if (m_lpszTemplateName != NULL || m_hDialogTemplate != NULL)
UnlockResource(hDialogTemplate);
if (m_lpszTemplateName != NULL)
FreeResource(hDialogTemplate);
return m_nModalResult;
}
從DoModal的實(shí)現(xiàn)可以看出:
它首先Disable對(duì)話框窗口的父窗口;然后使用::CreateIndrectDialog創(chuàng)建對(duì)話框窗口,使用子類化的方法用AfxWndProc(或者AfxBaseProc)替換了原來的窗口過程,并把原來的窗口過程保存在CWnd的成員變量m_pfnSuper中。原來的窗口過程就是::DialogBox等創(chuàng)建對(duì)話框窗口時(shí)指定的,是Windows內(nèi)部提供的對(duì)話框“窗口類”的窗口過程。取代(Subclass)原來“窗口類”的窗口過程的方法如同 4.4.1節(jié)描述的CWnd::Create。
在::CreateIndirectDialog創(chuàng)建對(duì)話框窗口后,會(huì)發(fā)送WM_INITDIALOG消息給對(duì)話框的對(duì)話框過程(必要的話,還有WM_SETFONT消息)。但是MFC取代了原來的對(duì)話框窗口過程,這兩個(gè)消息如何送給對(duì)話框過程呢?處理方法如下節(jié)所描述。
對(duì)話框的消息處理過程和其他窗口并沒有什么不同。這里主要分析的是如何把一些消息傳遞給對(duì)話框原窗口過程處理。下面,通過解釋MFC對(duì)WM_INITDIALOG消息的處理來解釋MFC窗口過程和原對(duì)話框窗口過程的關(guān)系及其協(xié)調(diào)作用。
MFC提供了WM_INITDIALOG消息的處理函數(shù)CDialog::HandleInitDialog,WM_INITDIALOG消息按照標(biāo)準(zhǔn)Windows的處理送給HandleInitDialog處理。
HandleInitDialog調(diào)用缺省處理過程Default,導(dǎo)致CWnd的Default函數(shù)被調(diào)用。CWnd::Default的實(shí)現(xiàn)如下:
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的實(shí)現(xiàn)可以看出線程狀態(tài)的一個(gè)用途:它把本線程最新收到和處理的消息記錄在成員變量m_lastSentMsg中。
在Default的實(shí)現(xiàn)中,CWnd的DefWindowsProc被調(diào)用,其實(shí)現(xiàn)如下:
LRESULT CWnd::DefWindowProc(UINT nMsg,
WPARAM wParam, LPARAM lParam)
{
//若“窗口超類(SuperClass)”的窗口過程m_pfnSuper非空,則調(diào)用它
if (m_pfnSuper != NULL)
return ::CallWindowProc(m_pfnSuper, m_hWnd, nMsg, wParam, lParam);
//在MFC中,GetSuperWndProcAddr的作用就是返回m_pfnSuper,為什么還
//要再次調(diào)用呢?因?yàn)殡m然該函數(shù)現(xiàn)在是Obsolete,但原來曾經(jīng)是有用的。如
//果返回非空,就調(diào)用該窗口過程進(jìn)行處理,否則,由Windows進(jìn)行缺省處理。
WNDPROC pfnWndProc;
if ((pfnWndProc = *GetSuperWndProcAddr()) == NULL)
return ::DefWindowProc(m_hWnd, nMsg, wParam, lParam);
else
return ::CallWindowProc(pfnWndProc, m_hWnd, nMsg, wParam, lParam);
}
綜合上述分析,HandleInitDialog最終調(diào)用了窗口過程m_pfnSuper,即Windows提供給“對(duì)話框窗口類”的窗口過程,于是該窗口過程調(diào)用了對(duì)話框過程AfxDlgProc,導(dǎo)致虛擬函數(shù)OnInitDialog被調(diào)用。
順便提一下,CWnd::AfxCallWndProc在處理WM_INITDIALOG消息之前和之后都會(huì)有一些特別的處理,如嘗試把對(duì)話框放到屏幕中間。具體實(shí)現(xiàn)這里略。
OnInitDialog的MFC缺省實(shí)現(xiàn)主要完成三件事情:
調(diào)用ExecInitDialog初始化對(duì)話框中的控制;調(diào)用UpdateData初始化對(duì)話框控制中的數(shù)據(jù);確定是否顯示幫助按鈕。所以,程序員覆蓋該函數(shù)時(shí),一定要調(diào)用基類的實(shí)現(xiàn)。
MFC采用子類化的方法取代了對(duì)話框的窗口過程,實(shí)現(xiàn)了12.1節(jié)描述的模式對(duì)話框窗口的一些特性,原來SDK下對(duì)話框過程要處理的東西大部分轉(zhuǎn)移給MFC窗口過程處理,如處理控制窗口的控制通知消息等。如果不能處理或者必須借助于原來的窗口過程的,則通過缺省處理函數(shù)Default傳遞給原來的窗口過程處理,如同這里對(duì)WM_INITDIALOG的處理一樣。
通過覆蓋CWnd的命令消息發(fā)送函數(shù)OnCmdMsg,CDialog實(shí)現(xiàn)了自己的命令消息發(fā)送路徑。在4.4.3.3節(jié),曾經(jīng)分析了CDialog::OnCmdMsg函數(shù),這里給出其具體實(shí)現(xiàn):
BOOL CDialog::OnCmdMsg(UINT nID, int nCode, void* pExtra,
AFX_CMDHANDLERINFO* pHandlerInfo)
{
//首先,讓對(duì)話框窗口自己或者基類處理
if (CWnd::OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))
return TRUE;
//如果還未處理,且是控制通知消息或者狀態(tài)更新消息或者系統(tǒng)命令
//則停止進(jìn)一步的發(fā)送
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;
}
// 最后,給當(dāng)前線程對(duì)象處理
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;
}
從上述實(shí)現(xiàn)可以看出,CDialog處理命令消息遵循如下順序:
對(duì)話框自身→父窗口→線程對(duì)象
例如,模式對(duì)話框產(chǎn)生的WM_ENTERIDLE消息就發(fā)送給父窗口處理。
從實(shí)現(xiàn)中還看到,MFC根據(jù)TRACE過濾標(biāo)識(shí)afxTraceFlags的值,把有關(guān)命令消息的派發(fā)顯示到調(diào)試窗口。
CDialog::OnCmdMsg不僅適用于模式對(duì)話框,也適用于無模式對(duì)話框。
另外,對(duì)話框窗口的消息處理還有一個(gè)特點(diǎn),就是增加了對(duì)Dialog消息的處理,如同在介紹::IsDialogMessage函數(shù)時(shí)所述。如果是Dialog消息,MFC框架將不會(huì)讓它進(jìn)入下一步的消息循環(huán)。為此,MFC覆蓋了CDialog的虛擬函數(shù)PreTranslateMessage,該函數(shù)的實(shí)現(xiàn)如下:
BOOL CDialog::PreTranslateMessage(MSG* pMsg)
{
// 用于無模式或者模式對(duì)話框的處理
ASSERT(m_hWnd != NULL);
//過濾tooltip messages
if (CWnd::PreTranslateMessage(pMsg))
return TRUE;
//在Shift+F1幫助模式下,不轉(zhuǎn)換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;
}
}
// 過濾來自控制該對(duì)話框子窗口的送給該對(duì)話框的Dialog消息
return PreTranslateInput(pMsg);
}
從其實(shí)現(xiàn)可以看出,如果是Tooltip消息或者Dialog消息,這些消息將在PreTranslateMessage中被處理,不會(huì)進(jìn)入消息發(fā)送的處理。
PreTranslateInput是CWnd的成員函數(shù),它調(diào)用::IsDialogMessage函數(shù)來處理Dialog消息。
PreTranslateMessage的實(shí)現(xiàn)不僅用于模式對(duì)話框,而且用于無模式對(duì)話框。
從DoModal的實(shí)現(xiàn)可以看出,DoModal調(diào)用CreateDlgIndirect創(chuàng)建的是無模式對(duì)話框,MFC如何來接管和控制應(yīng)用程序的消息隊(duì)列,實(shí)現(xiàn)一個(gè)模式對(duì)話框的功能呢?
CDialog調(diào)用了RunModalLoop來實(shí)現(xiàn)模式窗口的消息循環(huán)。RunModalLoop是CWnd的成員函數(shù),它和相關(guān)函數(shù)的實(shí)現(xiàn)如下:
int CWnd::RunModalLoop(DWORD dwFlags)
{
ASSERT(::IsWindow(m_hWnd)); //窗口必須已經(jīng)創(chuàng)建且不在模式狀態(tài) 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;
//獲取和派發(fā)消息直到模式狀態(tài)結(jié)束
for (;;)
{
ASSERT(ContinueModal());
//第一階段,判斷是否可以進(jìn)行Idle處理
while (bIdle &&!::PeekMessage(pMsg, NULL, NULL, NULL, PM_NOREMOVE))
{
ASSERT(ContinueModal());
//必要的話,當(dāng)Idle時(shí)顯示對(duì)話框窗口
if (bShowIdle)
{
ShowWindow(SW_SHOWNORMAL);
UpdateWindow();
bShowIdle = FALSE;
}
// 進(jìn)行Idle處理
//必要的話發(fā)送WM_ENTERIDLE消息給父窗口
if (!(dwFlags & MLF_NOIDLEMSG) &&hWndParent != NULL && lIdleCount == 0)
{
::SendMessage(hWndParent, WM_ENTERIDLE,
MSGF_DIALOGBOX, (LPARAM)m_hWnd);
}
//必要的話發(fā)送WM_KICKIDLE消息給父窗口
if ((dwFlags & MLF_NOKICKIDLE) ||
!SendMessage(WM_KICKIDLE, MSGF_DIALOGBOX, lIdleCount++))
{
//終止Idle處理
bIdle = FALSE;
}
}
//第二階段,發(fā)送消息
do
{
ASSERT(ContinueModal());
// 若是WM_QUIT消息,則發(fā)送該消息到消息隊(duì)列,返回;否則發(fā)送消息。
if (!AfxGetThread()->PumpMessage())
{
AfxPostQuitMessage(0);
return -1;
}
//必要的話,顯示對(duì)話框窗口
if (bShowIdle &&
(pMsg->message == 0x118 || pMsg->message == WM_SYSKEYDOWN))
{
ShowWindow(SW_SHOWNORMAL);
UpdateWindow();
bShowIdle = FALSE;
}
if (!ContinueModal())
goto ExitModal;
//在派發(fā)了“正常 ”消息后,重新開始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也分兩個(gè)階段進(jìn)行處理。不同之處在于,這里不同于Run的Idle處理,RunModalLoop是給父窗口發(fā)送WM_ENTERIDLE消息(如果需要的話);另外,當(dāng)前對(duì)話框的父窗口被Disabled,是不接收用戶消息的。
RunModalLoop是一個(gè)實(shí)現(xiàn)自己的消息循環(huán)的示例,消息循環(huán)的條件是模式化狀態(tài)沒有結(jié)束。實(shí)現(xiàn)線程自己的消息循環(huán)見8.5.6節(jié)。
當(dāng)用戶按下按鈕“取消”、“確定”時(shí),將導(dǎo)致RunModalLoop退出消息循環(huán),結(jié)束對(duì)話框模式狀態(tài),并調(diào)用::EndDialog關(guān)閉窗口。有關(guān)關(guān)閉對(duì)話框的處理如下:
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);
}
上述函數(shù)OnOk、OnCancle、EndDialog都可以用來關(guān)閉對(duì)話框窗口。其中:
OnOk首先進(jìn)行數(shù)據(jù)交換,獲取對(duì)話框中各個(gè)控制子窗口的數(shù)據(jù),然后調(diào)用EndDialog結(jié)束對(duì)話框。
OnCancle直接EndDialog結(jié)束對(duì)話框。
EndDialog首先修改m_nFlag的值,表示結(jié)束模式循環(huán),然后調(diào)用::EndDialog關(guān)閉對(duì)話框窗口。
對(duì)話框數(shù)據(jù)交換指以下兩種動(dòng)作,或者是把內(nèi)存數(shù)據(jù)寫入對(duì)應(yīng)的控制窗口,或者是從控制窗口讀取數(shù)據(jù)并保存到內(nèi)存變量中。MFC為了簡化這些操作,以CDataExchange類和一些數(shù)據(jù)交換函數(shù)為基礎(chǔ),提供了一套數(shù)據(jù)交換和校驗(yàn)的機(jī)制。
首先,定義保存數(shù)據(jù)的內(nèi)存變量──給對(duì)話框添加成員變量,每個(gè)控制窗口可以對(duì)應(yīng)一個(gè)成員變量,或者是控制窗口類型,或者是控制窗口表示的數(shù)據(jù)的類型。例如,對(duì)于對(duì)話框的一個(gè)編輯控制窗口,可以定義一個(gè)CEdit類型的成員變量,或者一個(gè)CString類型的成員變量。
其次,覆蓋對(duì)話框的虛擬函數(shù)DoDataExchange,實(shí)現(xiàn)數(shù)據(jù)交換和驗(yàn)證。
ClassWizard可以協(xié)助程序員自動(dòng)地添加成員變量,修改DoDataExchange。例如,一個(gè)對(duì)話框有兩個(gè)控制窗口,其中的一個(gè)編輯框表示姓名,ID是IDC_NAME,另一個(gè)編輯框表示年齡,ID是IDC_AGE,ClassWizard添加如下的成員變量:
// Dialog Data
//{{AFX_DATA(CExDialog)
enum { IDD = IDD_DIALOG2 };
CEdit m_name;
int m_iAge;
//}}AFX_DATA
使用ClassWizard添加成員變量中,一個(gè)定義為CEdit,另一個(gè)定義為int。這些定義被“//{{AFX_DATA”和“//}}AFX_DATA”引用,表示是ClassWizard添加的,程序員不必修改它們。
相應(yīng)的DoDataExchange的實(shí)現(xiàn)如下:
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子窗口的內(nèi)容傳輸?shù)酱翱趍_name,或者相反。
DDX_ Text表示把IDC_AGE子窗口的內(nèi)容按整數(shù)類型保存到m_nAge,或者相反。
DDV_MinMaxInt表示m_nAge應(yīng)該在1和100之間取值。
上文中提到DDX_Xxxxx數(shù)據(jù)交換函數(shù)可以進(jìn)行雙向的數(shù)據(jù)交換,那么它們?nèi)绾沃罃?shù)據(jù)傳輸?shù)姆较蚰??這通過DDX_Xxxxx函數(shù)的第一個(gè)參數(shù)pDX(也就是DoDataEx change的參數(shù)pDX)所指的CDataExchange對(duì)象來決定,pDX指向一個(gè)CdataExchange對(duì)象。CDataExchange定義如下:
class CDataExchange
{
// Attributes
public:
BOOL m_bSaveAndValidate; // TRUE 則 保存和驗(yàn)證數(shù)據(jù)
CWnd* m_pDlgWnd; // 指向一個(gè)對(duì)話框
// 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); // 用于對(duì)話框中的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函數(shù),CDataExchange類似于CArchive。CDataExchange使用成員變量m_pDlgWnd保存要進(jìn)行數(shù)據(jù)交換的對(duì)話框,使用成員變量m_bSaveAndValidate指示數(shù)據(jù)傳輸?shù)姆较颍绻撟兞空?,則從控制窗口讀取數(shù)據(jù)到成員變量,如果假,則從成員變量寫數(shù)據(jù)到控制窗口。
在構(gòu)造一個(gè)CDataExchange對(duì)象時(shí),將保存有關(guān)信息在對(duì)象的成員變量中。構(gòu)造函數(shù)如下:
CDataExchange::CDataExchange(CWnd* pDlgWnd, BOOL bSaveAndValidate)
{
ASSERT_VALID(pDlgWnd);
m_bSaveAndValidate = bSaveAndValidate;
m_pDlgWnd = pDlgWnd;
m_hWndLastControl = NULL;
}
構(gòu)造函數(shù)參數(shù)指定了進(jìn)行數(shù)據(jù)交換的對(duì)話框pDlgWnd和數(shù)據(jù)傳輸方向bSaveAndValidate。
在進(jìn)行數(shù)據(jù)交換或者驗(yàn)證時(shí),首先使用PrePareCtrl或者PrePareEditCtrl得到控制窗口的句柄,然后使用::GetWindowsText從控制窗口讀取數(shù)據(jù),或者使用::SetWindowsText寫入數(shù)據(jù)到控制窗口。下面討論幾個(gè)例子:
int nIDC,LPCTSTR lpszFormat, UINT nIDPrompt, ...)
{
va_list pData; //用來處理個(gè)數(shù)可以變化的參數(shù)
va_start(pData, nIDPrompt);//得到參數(shù)
//得到編輯框的句柄
HWND hWndCtrl = pDX->PrepareEditCtrl(nIDC);
TCHAR szT[32];
if (pDX->m_bSaveAndValidate) //TRUE,從編輯框讀出數(shù)據(jù)
{
// the following works for %d, %u, %ld, %lu
//從編輯框得到內(nèi)容
::GetWindowText(hWndCtrl, szT, _countof(szT));
//轉(zhuǎn)換編輯框內(nèi)容為指定的格式,支持“ %d, %u, %ld, %lu”
if (!AfxSimpleScanf(szT, lpszFormat, pData))
{
AfxMessageBox(nIDPrompt);
pDX->Fail(); //數(shù)據(jù)交換失敗
}
}
else //FALSE,寫入數(shù)據(jù)到編輯框
{
//把要寫的內(nèi)容轉(zhuǎn)換成指定格式
wvsprintf(szT, lpszFormat, pData);//不支持浮點(diǎn)運(yùn)算
//設(shè)置編輯框的內(nèi)容
AfxSetWindowText(hWndCtrl, szT);
}
va_end(pData);//結(jié)束參數(shù)分析
}
DDX_TextWithFormat用來按照一定的格式把數(shù)據(jù)寫入或者讀出編輯框。首先,它得到編輯框的句柄hWndCtrl,然后,根據(jù)傳輸方向從編輯框讀出內(nèi)容并轉(zhuǎn)換成指定格式(讀出時(shí)),或者轉(zhuǎn)換內(nèi)容為指定格式后寫入編輯框(寫入時(shí))。本函數(shù)可以處理個(gè)數(shù)不定的參數(shù),是多個(gè)數(shù)據(jù)交換和驗(yàn)證函數(shù)的基礎(chǔ)。
{
if (pDX->m_bSaveAndValidate)
DDX_TextWithFormat(pDX, nIDC, _T("%ld"), AFX_IDP_PARSE_INT, &value);
else
DDX_TextWithFormat(pDX, nIDC, _T("%ld"), AFX_IDP_PARSE_INT, value);
}
上述DDX_TEXT用來在編輯框和long類型的數(shù)據(jù)成員之間交換數(shù)據(jù)。MFC提供了DDX_TEXT的多個(gè)重載函數(shù)處理編輯框和不同類型的數(shù)據(jù)成員之間的數(shù)據(jù)交換。
{
//得到列表框句柄
HWND hWndCtrl = pDX->PrepareCtrl(nIDC);
if (pDX->m_bSaveAndValidate)//TRUE,讀取數(shù)據(jù)
{
//確定列表框當(dāng)前被選擇的條目
int nIndex = (int)::SendMessage(hWndCtrl, LB_GETCURSEL, 0, 0L);
if (nIndex != -1) //列表框有一個(gè)條目被選中
{
//得到當(dāng)前條目的長度
int nLen = (int)::SendMessage(hWndCtrl, LB_GETTEXTLEN, nIndex, 0L);
//讀取當(dāng)前條目的內(nèi)容到value中
::SendMessage(hWndCtrl, LB_GETTEXT, nIndex,
(LPARAM)(LPVOID)value.GetBufferSetLength(nLen));
}
else //當(dāng)前列表框沒有條目被選中
{
value.Empty();
}
value.ReleaseBuffer();
}
else//FALSE,寫內(nèi)容到列表框
{
// 把value字符串寫入當(dāng)前選中的條目
if (::SendMessage(hWndCtrl, LB_SELECTSTRING,
(WPARAM)-1,(LPARAM)(LPCTSTR)value) == LB_ERR)
{
// no selection match
TRACE0("Warning: no listbox item selected.\n");
}
}
}
DDX_LBString用來在列表框和CString類型的成員數(shù)據(jù)之間交換數(shù)據(jù)。首先,得到列表框的句柄,然后,調(diào)用Win32的列表框操作函數(shù)讀取或者修改列表框的內(nèi)容。
void AFXAPI DDX_Control(CDataExchange* pDX, int nIDC, CWnd& rControl)
{
if (rControl.m_hWnd == NULL) // 還沒有子類化
{
ASSERT(!pDX->m_bSaveAndValidate);
//得到控制窗口句柄
HWND hWndCtrl = pDX->PrepareCtrl(nIDC);
//把hWndCtrl窗口和MFC窗口對(duì)象rControl捆綁在一起
if (!rControl.SubclassWindow(hWndCtrl))
{
ASSERT(FALSE); //不允許兩次子類化
AfxThrowNotSupportedException();
}
#ifndef _AFX_NO_OCC_SUPPORT//OLE控制相關(guān)的操作
else
{
// If the control has reparented itself (e.g., invisible control),
// make sure that the CWnd gets properly wired to its control site.
if (pDX->m_pDlgWnd->m_hWnd != ::GetParent(rControl.m_hWnd))
rControl.AttachControlSite(pDX->m_pDlgWnd);
}
#endif //!_AFX_NO_OCC_SUPPORT
}
}
DDX_Control用來把控制窗口(Windows窗口)和一個(gè)對(duì)話框成員(MFC窗口對(duì)象)捆綁在一起,這個(gè)過程是通過SubclassWindow函數(shù)完成的。這樣,程序員就可以通過成員變量來操作控制窗口,讀、寫、修改控制窗口的內(nèi)容。
MFC還提供了許多其他數(shù)據(jù)交換函數(shù)(“DDX_”為前綴)和數(shù)據(jù)驗(yàn)證函數(shù)(“DDV_”為前綴)。DDV函數(shù)和DDX函數(shù)類似,這里不再多述。
程序員可以創(chuàng)建自己的數(shù)據(jù)交換和驗(yàn)證函數(shù)并使用它們,可以手工加入這些函數(shù)到DoDataExchange中,如果要Classwizard使用這些函數(shù),可以修改DDX.CLW文件,在DDX、DDV函數(shù)入口中加入自己創(chuàng)建的函數(shù)。
有了數(shù)據(jù)交換類和數(shù)據(jù)交換函數(shù),怎么來使用它們呢?MFC設(shè)計(jì)了UpdateData函數(shù)來完成上述數(shù)據(jù)交換和驗(yàn)證的處理。
首先,UpdateData創(chuàng)建CDataExchange對(duì)象,然后調(diào)用DoDataExchange函數(shù)。其實(shí)現(xiàn)如下:
BOOL CWnd::UpdateData(BOOL bSaveAndValidate)
{
ASSERT(::IsWindow(m_hWnd)); // calling UpdateData before DoModal?
//創(chuàng)建CDataChange對(duì)象
CDataExchange dx(this, bSaveAndValidate);
//防止在UpdateData期間派發(fā)通知消息給該窗口
_AFX_THREAD_STATE* pThreadState = AfxGetThreadState();
HWND hWndOldLockout = pThreadState->m_hLockoutNotifyWindow;
ASSERT(hWndOldLockout != m_hWnd); // must not recurse
pThreadState->m_hLockoutNotifyWindow = m_hWnd;
BOOL bOK = FALSE; // assume failure
TRY
{
//數(shù)據(jù)交換
DoDataExchange(&dx);
bOK = TRUE; // it worked
}
CATCH(CUserException, e)//例外
{
// validation failed - user already alerted, fall through
ASSERT(bOK == FALSE);
// Note: DELETE_EXCEPTION_(e) not required
}
AND_CATCH_ALL(e)
{
// validation failed due to OOM or other resource failure
e->ReportError(MB_ICONEXCLAMATION, FX_IDP_INTERNAL_FAILURE);
ASSERT(!bOK);
DELETE_EXCEPTION(e);
}
END_CATCH_ALL
//恢復(fù)原來的值
pThreadState->m_hLockoutNotifyWindow = hWndOldLockout;
return bOK;
}
UpdataDate根據(jù)參數(shù)創(chuàng)建CDataExchange對(duì)象dx,如果參數(shù)為TRUE,dx用來寫數(shù)據(jù),否則dx用來讀數(shù)據(jù);然后調(diào)用DoDataExchange進(jìn)行數(shù)據(jù)交換。在數(shù)據(jù)交換期間,為了防止當(dāng)前窗口接收和處理命令通知消息,在當(dāng)前線程的線程狀態(tài)中記錄該窗口的句柄,用來防止給該窗口發(fā)送通知消息。
使用MFC的數(shù)據(jù)交換和驗(yàn)證機(jī)制,大大簡化了程序員的工作。通常在OnInitDialog中,MFC調(diào)用UpdateData(FALSE)把數(shù)據(jù)送給控制窗口顯示;在OnOk中,調(diào)用UpdateData(TRUE)從控制窗口中讀取數(shù)據(jù)。
CScrollView繼承了CView的特性,并且增加了如下的功能:
(1)管理映射模式、窗口尺寸、視口尺寸(Map mode、Window and Viewport size)。Window and Viewport size用來完成頁面空間到設(shè)備空間的轉(zhuǎn)換。
(2)自動(dòng)管理滾動(dòng)條,響應(yīng)滾動(dòng)條消息。
為了實(shí)現(xiàn)這些功能,CScrollView覆蓋CView或者CWnd的一些虛擬函數(shù)和消息處理函數(shù),添加了一些新的函數(shù),當(dāng)然也設(shè)計(jì)了新的成員變量。
protected:
int m_nMapMode;
CSize m_totalLog; // total size in logical units (no rounding)
CSize m_totalDev; // total size in device units
CSize m_pageDev; // per page scroll size in device units
CSize m_lineDev; // per line scroll size in device units
BOOL m_bCenter; // Center output if larger than total size
BOOL m_bInsideUpdate; // internal state for OnSize callback
void SetScaleToFitSize(SIZE sizeTotal);
void SetScrollSizes(int nMapMode, SIZE sizeTotal,
const SIZE& sizePage = sizeDefault,
const SIZE& sizeLine = sizeDefault);
這兩個(gè)函數(shù)中的尺寸大小按邏輯單位計(jì)算。
SetScaleToFitSize設(shè)置視口尺寸為當(dāng)前的窗口尺寸,這樣,在沒有滾動(dòng)條時(shí),邏輯視的內(nèi)容被放大或者縮小到正好窗口大小。
SetScrollSizes設(shè)置窗口的映射模式,窗口尺寸,頁和行尺寸。sizeDefualt被定義為(0,0)。
void ScrollToPosition(POINT pt); // set upper left position
void FillOutsideRect(CDC* pDC, CBrush* pBrush);
void ResizeParentToFit(BOOL bShrinkOnly = TRUE);
CPoint GetScrollPosition() const; // upper corner of scrolling
CSize GetTotalSize() const; // logical size
CPoint GetDeviceScrollPosition() const;
void GetDeviceScrollSizes(int& nMapMode, SIZE& sizeTotal,
SIZE& sizePage, SIZE& sizeLine) const;
處理WM_SIZE的OnSize;
處理WM_HSCROLL的OnHScroll;
處理WM_VSCROLL的OnVScroll;
CWnd的CalcWindowRect
CView的OnPrepareDC、OnScroll、OnScrollBy
這里,覆蓋的消息處理函數(shù)和虛擬函數(shù)共同完成對(duì)滾動(dòng)條、滾動(dòng)消息的處理。
在CSrcollView的實(shí)現(xiàn)涉及到許多和Windows映射模式、坐標(biāo)轉(zhuǎn)換等相關(guān)的函數(shù)的使用。這里,不作具體討論。
CFormView派生于CSrcollView,本身沒有增加新的函數(shù),但覆蓋了一些基類的虛擬函數(shù),增加了幾個(gè)成員變量(以下列出的不包含OLE處理)。
LPCTSTR m_lpszTemplateName;
CCreateContext* m_pCreateContext;
HWND m_hWndFocus; // last window to have focus
m_lpszTemplateName用來保存創(chuàng)建視圖的對(duì)話框模板的名稱,_pCreateContext用來保存創(chuàng)建上下文,m_hWndFocus用來保存最近一次擁有焦點(diǎn)的控制窗口。在構(gòu)造CFormView對(duì)象時(shí),構(gòu)造函數(shù)把有關(guān)信息保存到成員變量中,如下所示:
CFormView::CFormView(LPCTSTR lpszTemplateName)
{
m_lpszTemplateName = lpszTemplateName;
m_pCreateContext = NULL;
m_hWndFocus = NULL; // focus window is font
}
virtual void OnDraw(CDC* pDC); // MFC缺省處理空
virtual BOOL Create(LPCTSTR, LPCTSTR, DWORD,
const RECT&, CWnd*, UINT, CCreateContext*);
virtual BOOL PreTranslateMessage(MSG* pMsg);
virtual void OnActivateView(BOOL, CView*, CView*);
virtual void OnActivateFrame(UINT, CFrameWnd*);
創(chuàng)建基于對(duì)話框的視窗口,不同于創(chuàng)建普通視窗口(前者調(diào)用CWnd::CreateEx,后者調(diào)用CWnd::CreateDlg),故需要覆蓋Create虛擬函數(shù)。
覆蓋PreTranslateMessage是為了過濾對(duì)話框消息,把一些消息讓CFormView對(duì)象來處理。
afx_msg int OnCreate(LPCREATESTRUCT lpcs);
afx_msg void OnSetFocus(CWnd* pOldWnd);
下面,分析幾個(gè)函數(shù)作。Create函數(shù)解釋了MFC如何使用一個(gè)對(duì)話框作為視的方法,PreTranslateMessage顯示了CFormView不同于CDialog的實(shí)現(xiàn)。
設(shè)計(jì)CFormView的創(chuàng)建函數(shù),必須考慮兩個(gè)問題:
首先,CFormView是一個(gè)視,其創(chuàng)建函數(shù)必須是一個(gè)虛擬函數(shù),原型必須和CWnd::Create(LPSTR…pContext)函數(shù)一致,見圖5-13視的創(chuàng)建。其次,CFormView使用了對(duì)話框創(chuàng)建函數(shù)和對(duì)話框“窗口類”來創(chuàng)建視,但必須作一些處理使得該窗口具備視的特征。
Create的實(shí)現(xiàn)如下:
BOOL CFormView::Create(LPCTSTR /*lpszClassName*/,
LPCTSTR /*lpszWindowName*/,
DWORD dwRequestedStyle, const RECT& rect, CWnd* pParentWnd, UINT nID,
CCreateContext* pContext)
{
ASSERT(pParentWnd != NULL);
ASSERT(m_lpszTemplateName != NULL);
m_pCreateContext = pContext; // save state for later OnCreate
#ifdef _DEBUG
// dialog template must exist and be invisible with WS_CHILD set
if (!_AfxCheckDialogTemplate(m_lpszTemplateName, TRUE))
{
ASSERT(FALSE); // invalid dialog template name
PostNcDestroy(); // cleanup if Create fails too soon
return FALSE;
}
#endif //_DEBUG
//若common control window類還沒有注冊(cè),則注冊(cè)
VERIFY(AfxDeferRegisterClass(AFX_WNDCOMMCTLS_REG));
// call PreCreateWindow to get prefered extended style
CREATESTRUCT cs; memset(&cs, 0, sizeof(CREATESTRUCT));
if (dwRequestedStyle == 0)
dwRequestedStyle = AFX_WS_DEFAULT_VIEW;
cs.style = dwRequestedStyle;
if (!PreCreateWindow(cs))
return FALSE;
//::CreateDialogIndirect間接被調(diào)用來創(chuàng)建一個(gè)無模式對(duì)話框
if (!CreateDlg(m_lpszTemplateName, pParentWnd))
return FALSE;
//創(chuàng)建對(duì)話框時(shí),OnCreate被調(diào)用,m_pCreateContext的作用結(jié)束了
m_pCreateContext = NULL;
// we use the style from the template - but make sure that
// the WS_BORDER bit is correct
// the WS_BORDER bit will be whatever is in dwRequestedStyle
ModifyStyle(WS_BORDER|WS_CAPTION, cs.style & (WS_BORDER|WS_CAPTION));
ModifyStyleEx(WS_EX_CLIENTEDGE, cs.dwExStyle & WS_EX_CLIENTEDGE);
SetDlgCtrlID(nID);
CRect rectTemplate;
GetWindowRect(rectTemplate);
SetScrollSizes(MM_TEXT, rectTemplate.Size());
// initialize controls etc
if (!ExecuteDlgInit(m_lpszTemplateName))
return FALSE;
// force the size requested
SetWindowPos(NULL, rect.left, rect.top,
rect.right - rect.left, rect.bottom - rect.top,
SWP_NOZORDER|SWP_NOACTIVATE);
// make visible if requested
if (dwRequestedStyle & WS_VISIBLE)
ShowWindow(SW_NORMAL);
return TRUE;
}
從Create的實(shí)現(xiàn)過程可以看出,CreateDialog在創(chuàng)建對(duì)話框時(shí)使用了Windows預(yù)定義的對(duì)話框“窗口類”,PreCreateWindow返回的cs在創(chuàng)建對(duì)話框窗口時(shí)并沒有得到體現(xiàn),所以在CFormView::Create調(diào)用PreCreateWindow讓程序員修改“窗口類”的風(fēng)格之后,還要調(diào)用ModifyStyle和ModifyStyleEx來按PreCreateWindow返回的cs的值修改窗口風(fēng)格。
回顧視窗口的創(chuàng)建過程,Create函數(shù)被CFrameWnd::CreateView所調(diào)用,參數(shù)nID取值A(chǔ)FX_IDW_PANE_FIRST。由于CreateDlg設(shè)置對(duì)話框窗口的ID為對(duì)話框模板的ID,所以需要調(diào)用函數(shù)SetDlgCtrlID(nID)設(shè)置視窗口ID為nID(即AFX_IDW_PANE_FIRST)。
由于CFormView是從CScrollView繼承,所以調(diào)用SetScrollSize設(shè)置映射模式,窗口尺寸等。
完成上述動(dòng)作之后,初始化對(duì)話框的控制子窗口。
最后,必要的話,顯示視窗口。
這樣,一個(gè)無模式對(duì)話框被創(chuàng)建,它被用作當(dāng)前MDI窗口或者M(jìn)DI子窗口的視。如同CDialog的消息處理一樣,必要時(shí),消息或者事件將傳遞給視原來的窗口過程(無模式對(duì)話框的原窗口過程)處理,其他的消息處理和通常視一樣。
由于是調(diào)用對(duì)話框創(chuàng)建函數(shù)創(chuàng)建視窗口,所以不能向::CreateWindowEX傳遞創(chuàng)建上下文指針,于是把它保存到成員變量m_pCreateContext中,在OnCreate時(shí)使用。OnCreate的實(shí)現(xiàn)如下:
int CFormView::OnCreate(LPCREATESTRUCT lpcs)
{
//既然不能通過CreateDialog使用參數(shù)傳遞的方法得到創(chuàng)建上下文
//參數(shù),則使用一個(gè)成員變量來傳遞
return CScrollView::OnCreate(lpcs);
}
現(xiàn)在,討論CFormView 的PreTranslateMessage函數(shù)。CDialog覆蓋函數(shù)PreTranslateMessage的主要目的是處理Tooltip消息、Escape鍵盤消息和Dialog消息。CFormView覆蓋該函數(shù)的目的是處理Tooltip消息和Dialog消息。CFormView和CDialog不同之處在于CFormView是一個(gè)視,故在把鍵盤消息當(dāng)Dialog消息處理之前,必須優(yōu)先讓其父窗口檢查按下的鍵是否是快捷鍵。PreTranslateMessage函數(shù)實(shí)現(xiàn)如下:
BOOL CFormView::PreTranslateMessage(MSG* pMsg)
{
ASSERT(pMsg != NULL);
ASSERT_VALID(this);
ASSERT(m_hWnd != NULL);
//過濾Tooltip消息
if (CView::PreTranslateMessage(pMsg))
return TRUE;
//SHIFT+F1上下文幫助模式下,不處理Dialog消息
CFrameWnd* pFrameWnd = GetTopLevelFrame();
if (pFrameWnd != NULL && pFrameWnd->m_bHelpMode)
return FALSE;
//既然IsDialogMessage將把窗口快捷鍵解釋成Dialog消息
//所以在此先調(diào)用所有父邊框窗口的消息預(yù)處理函數(shù)
pFrameWnd = GetParentFrame(); // start with first parent frame
while (pFrameWnd != NULL)
{
// allow owner & frames to translate before IsDialogMessage does
if (pFrameWnd->PreTranslateMessage(pMsg))
return TRUE;
// try parent frames until there are no parent frames
pFrameWnd = pFrameWnd->GetParentFrame();
}
// 過濾來自子窗口的消息或者給對(duì)話框的消息
return PreTranslateInput(pMsg);
}
由于CFormView是一個(gè)視,不是模式對(duì)話框,所以它首先要把消息給父窗口(MDI子窗口或者M(jìn)DI窗口)預(yù)處理,如果它們不能處理,則調(diào)用PreTranslateInput來過濾Dialog消息。
CFormView另一個(gè)特性是:在和用戶交互中,如果用戶離開視窗口,則必須保存CFormView視的哪個(gè)控制子窗口擁有輸入焦點(diǎn),以便在重新激活視窗口時(shí),原來的那個(gè)窗口重新獲得輸入焦點(diǎn)。所以,CFormView覆蓋了虛擬函數(shù)OnActivateView和OnActiveFrame,以便在視窗口失去激活時(shí)把它的當(dāng)前輸入焦點(diǎn)保存到成員變量m_hWndFocus中。
為了在適當(dāng)時(shí)候恢復(fù)輸入焦點(diǎn),CFormView覆蓋了消息處理函數(shù)OnSetFocus,以便在視獲得輸入焦點(diǎn)時(shí)把輸入焦點(diǎn)傳遞給m_hWndFocus(如果非空)。
至此,MFC實(shí)現(xiàn)對(duì)話框的處理分析完畢。
在后面要討論的工具條等控制窗口,類似于對(duì)話框也具備由Windows提供的窗口過程,MFC在SDK的特定控制窗口創(chuàng)建函數(shù)的基礎(chǔ)上,提供了MFC的窗口創(chuàng)建函數(shù),使用MFC的窗口過程取代了它們?cè)瓉淼拇翱谶^程,然后在必要的時(shí)候調(diào)用Default把有關(guān)消息和事件傳遞給原來的窗口過程處理。
聯(lián)系客服