WTL體系結構緒論
WTL最終來(lái)了,而且提供了我所希望的功能.我在
WTL Bytesize(
譯文)的文章列出WTL主要特征.在本文中,我將描述一下WTL的體系結構,同時(shí)我會(huì )給出一些簡(jiǎn)單的例子來(lái)演示如何使用它的那些特征.希望能夠對您有所幫助.
WTL應用程序的類(lèi)型
WTL有好幾種應用程序類(lèi)型,供您在A(yíng)ppWizard選取.
下表對這些應用程序進(jìn)行了描述. 這種彈性構成了WTL體系結構的一部分.
應用程序類(lèi)型描述
SDI Application單文本界面 – 只有一個(gè)窗口
Multiple Threads SDI單個(gè)進(jìn)程擁有一個(gè)或多個(gè)窗口
MDI Application多文本界面 – 在框架內,您可以有零個(gè)或多個(gè)子窗口
Dialog Based基于對話(huà)框模版
你可能還是首次聽(tīng)說(shuō)多線(xiàn)程SDI應用程序,但是不用擔心,它的概念很容易理解.一個(gè)多線(xiàn)程SDI程序啟動(dòng)后它會(huì )有一個(gè)窗口, 窗口顯示了一個(gè)文檔. 當你想要程序要再創(chuàng )建一個(gè)文檔時(shí),問(wèn)題就出現了--SDI程序只能顯示一個(gè)文檔.為了解決這個(gè)問(wèn)題,多線(xiàn)程SDI創(chuàng )建了另一個(gè)SDI窗口.看起來(lái)是一個(gè)新的實(shí)例在運行,實(shí)際上它不過(guò)是原來(lái)的進(jìn)程創(chuàng )建了一個(gè)新的窗口,并把它依附到進(jìn)程的一個(gè)新線(xiàn)程. IE的新建窗口就是這樣做的.
除了多線(xiàn)程SDI,所有這些應用程序都可以作為COM服務(wù)器, 并且應用程序向導(AppWizard)為此提供了一個(gè)選項.另外應用程序向導還可以讓你指定該程序是否主持ActiveX控件.令人費解的是,不同的程序類(lèi)型,選取"Host ActiveX Controls"的地方不同.除對話(huà)框應用程序外的其他類(lèi)型在第一頁(yè)上選取,而對話(huà)框類(lèi)型卻放到第二頁(yè).
第二頁(yè)的其他選項,對對話(huà)框程序以外的類(lèi)型都是可用的.它們讓你指定程序是否需要工具條(toolbar),狀態(tài)條(status bar)和視窗口(View Window).
如果選取了"Toolbar"選項,你可以通過(guò)"Rebar"選擇是否將工具條放入IE Rebar控件中. 如果你選取了Rebar, 你就可以通過(guò)框架窗口(frame window)的成員m_hWndToolBar(后邊會(huì )有詳細的描述)來(lái)訪(fǎng)問(wèn)它.你可以按照你的意愿,在里邊加入其他的工具條. 選取了"Rebar"后, 你可以決定是否選取"Command Bar". Command bar很像CE的command bar控件.只是WTL是用一個(gè)類(lèi)來(lái)實(shí)現,而在CE, command bar是一個(gè)系統窗口類(lèi)(system window class). Command bar非常有用,它能夠把窗口也加入到工具條中去. 如果你選取了這個(gè)選項, 工具條和菜單都將被當做toolbar來(lái)實(shí)現.這使菜單項也可以有關(guān)聯(lián)的圖標,并且當你移動(dòng)鼠標到一個(gè)菜單項上時(shí),該菜單項會(huì )被置成高亮.從Office 97以來(lái), Office軟件的菜單都具有上述特征.
第二頁(yè)還有指定程序是否使用視的選項(多半你想要使用), 同時(shí)你可以決定這些視如何實(shí)現. 下表列出了所有可選的視.
視描述
Generic Window一個(gè)簡(jiǎn)單的窗口. 此類(lèi)窗口允許程序員編寫(xiě)WM_PAINT消息的處理函數. 適用于需要直接進(jìn)行paint的文檔.
Form這類(lèi)視具有一個(gè)對話(huà)框模版.適用于帶ActiveX 控件的窗口. 應用程序來(lái)操作這些控件.
List Box這個(gè)視是個(gè)list box.它最簡(jiǎn)單的形式意味著(zhù)可以通過(guò)調用AddString() 方法來(lái)添加字符串.
Edit這個(gè)視是個(gè)edit control. 本質(zhì)上,它提供了一個(gè)像Notepad一樣的程序.
List View這個(gè)視是個(gè)list view 通用控件.用這個(gè)控件來(lái)顯示相關(guān)的項(比如, 控制面板是一個(gè)Explorer主持的List View, 所有的項都是控制面板applet).
Tree View這個(gè)視是個(gè)tree view 通用控件. 這個(gè)適用于具有層次關(guān)系的數據,比如,可以用它來(lái)顯示數據庫的schema. 頂層分支為表和存儲過(guò)程,次級的分支為表中的字段.
Rich Edit這個(gè)視是個(gè)rich edit 控件,像WordPad.
HTML Page這個(gè)視主持了一個(gè)IE Web Browser 控件. 它把主持的一個(gè)web page當成一個(gè)視.
本文的例子需要一個(gè)對話(huà)框模版,同時(shí)還需要菜單,因此Form view是個(gè)理想的選擇.
程序線(xiàn)程
跟ATL一樣,WTL程序也需要一個(gè)_Module全局變量來(lái)保存全局數據,方便應用級代碼訪(fǎng)問(wèn).在WTL中,這個(gè)變量是CAppModule或CServerAppModule的實(shí)例,后者在程序同時(shí)作為一個(gè)COM服務(wù)器時(shí)用到.每個(gè)應用程序具有一個(gè)或者多個(gè)UI線(xiàn)程.WTL使用兩種方式來(lái)管理這些線(xiàn)程.
如果應用程序只有一個(gè)UI線(xiàn)程(除了多線(xiàn)程SDI以外,其他程序類(lèi)型默認只有一個(gè)UI線(xiàn)程),線(xiàn)程調用全局函數run():
int Run(LPTSTR /*lpstrCmdLine*/ = NULL, int nCmdShow = SW_SHOWDEFAULT)
{
CMessageLoop theLoop;
_Module.AddMessageLoop(&theLoop);
CMainFrame wndMain;
if (wndMain.CreateEx() == NULL)
{
ATLTRACE(_T("Main window creation failed!\n"));
return 0;
}
wndMain.ShowWindow(nCmdShow);
int nRet = theLoop.Run();
_Module.RemoveMessageLoop();
return nRet;
}
線(xiàn)程的消息循環(huán)包含在CMessageLoop內部.函數創(chuàng )建了一個(gè)CMessageLoop實(shí)例, 把它放入全局的消息循環(huán)映射(message loop map)數組. 以線(xiàn)程ID為索引,線(xiàn)程中運行的其他的代碼可以訪(fǎng)問(wèn)到這個(gè)實(shí)例. 消息循環(huán)對象包含了message filter和idle handler. 運行在這個(gè)UI線(xiàn)程的UI元件(UI element)可以有它自己的idle handler,在線(xiàn)程的消息隊列為空時(shí)運行【譯注:通過(guò)CMessageLoop::AddIdleHandler()把這個(gè)UI元件加入到CMessageLoop的idle handler 數組中】. CMessageLoop::Run()包含了UI線(xiàn)程的主消息映射(main message map).下邊是它的偽代碼:
MSG m_msg;
int CMessageLoop::Run()
{
for (;;)
{
while (!::PeekMessage(&m_msg, NULL, 0, 0, PM_NOREMOVE))
DoIdleHandlers();
bRet = ::GetMessage(&m_msg, NULL, 0, 0);
if(bRet == -1)
continue;
else if(!bRet)
break;
if (!DoMessageFilters(&m_msg))
{
::TranslateMessage(&m_msg);
::DispatchMessage(&m_msg);
}
}
return (int)m_msg.wParam;
}
可以看到,這個(gè)函數推動(dòng)著(zhù)消息隊列. 沒(méi)有消息時(shí), 運行注冊到線(xiàn)程的idle hander. 如果在隊列中檢測到消息,把它取出來(lái),傳給每個(gè)message filter. 如果消息沒(méi)有被這些函數處理,它將按照通常的方式,發(fā)送到目標窗口.
如果程序有超過(guò)一個(gè)的UI線(xiàn)程,可以用WTL的線(xiàn)程管理器,多線(xiàn)程SDI就是這樣做的. 主線(xiàn)程作為一個(gè)管理者線(xiàn)程,它會(huì )為每個(gè)新窗口創(chuàng )建一個(gè)新的新線(xiàn)程. 主要流程如下:
int nRet = m_dwCount;
DWORD dwRet;
while(m_dwCount > 0)
{
dwRet = ::MsgWaitForMultipleObjects(m_dwCount, m_arrThreadHandles,
FALSE, INFINITE, QS_ALLINPUT);
if(dwRet >= WAIT_OBJECT_0 && dwRet <= (WAIT_OBJECT_0 + m_dwCount - 1))
RemoveThread(dwRet - WAIT_OBJECT_0);
else if(dwRet == (WAIT_OBJECT_0 + m_dwCount))
{
::GetMessage(&msg, NULL, 0, 0);
if(msg.message == WM_USER)
AddThread(_T(""), SW_SHOWNORMAL);
}
}
那些線(xiàn)程句柄放在一個(gè)數組中. 線(xiàn)程通過(guò)AddThread()加入到數組(同時(shí)啟動(dòng)線(xiàn)程), RemoveThread()從數組移走. wait語(yǔ)句在兩種情況下會(huì )被打斷: 線(xiàn)程死亡(將線(xiàn)程從數組中移出) 或線(xiàn)程收到了WM_USER消息(一個(gè)線(xiàn)程在一個(gè)新線(xiàn)程里新建了一個(gè)窗口). 線(xiàn)程管理者為程序中的一個(gè)類(lèi),因此可以在循環(huán)中加入自己的message handler, 比如,當程序有不止一種窗口類(lèi)型時(shí). 創(chuàng )建一個(gè)新的窗口非常簡(jiǎn)單,只需在任意一個(gè)窗口中調用:
::PostThreadMessage(_Module.m_dwMainThreadID, WM_USER, 0, 0L);
這個(gè)循環(huán)會(huì )一直運行下去,直到所有的UI線(xiàn)程都關(guān)閉了. UI線(xiàn)程具有一個(gè)thread procedure,它跟單UI線(xiàn)程的Run()方法一樣.不過(guò),由于線(xiàn)程管理者使用了MsgWaitForMultipleObjects(), 這意味者最多只能有MAXIMUM_WAIT_OBJECTS-1個(gè)UI線(xiàn)程,這也意味著(zhù)最多只能創(chuàng )建63個(gè)窗口.
框架
WTL實(shí)際上是兩類(lèi)窗口: 框架窗口和視圖窗口. 正如名字所暗示的那樣, 框架窗口為窗口提供標題欄(caption bar)和邊框,你的代碼用它來(lái)處理工具條(tool bar)和菜單項命令.你看到的程序窗口實(shí)際上是視圖窗口, 視圖覆蓋了框架窗口的客戶(hù)區.客戶(hù)區是指框架窗口沒(méi)有被諸如狀態(tài)條,工具條之類(lèi)的修飾部件所遮擋的部分.
線(xiàn)程會(huì )創(chuàng )建主框架窗口的一個(gè)實(shí)例,創(chuàng )建視圖的工作由主框架窗口的WM_CREATE消息處理函數完成. 對于SDI程序來(lái)說(shuō),這個(gè)過(guò)程很簡(jiǎn)單. 把視圖類(lèi)的一個(gè)實(shí)例作為主框架類(lèi)的一個(gè)成員,調用視圖類(lèi)的Create()方法即可.MDI程序稍微有些不同, MDI主框架窗口通過(guò)CMDIFrameWindowImpl<>::CreateMDIClient()建立一個(gè)名為MDICLIENT的窗口. 這個(gè)客戶(hù)窗口將CMDIChildWindowImpl<>窗口當做它的子窗口,子窗口有一個(gè)視圖.這也反映了這么一個(gè)事實(shí),MDI程序可以具有零個(gè)或者多個(gè)子窗口,每個(gè)都有邊框和標題欄.
框架窗口的OnCreate()很有意思,讓我看看:
LRESULT OnCreate(UINT, WPARAM, LPARAM, BOOL&)
{
// create command bar window
HWND hWndCmdBar = m_CmdBar.Create(m_hWnd, rcDefault,
NULL, ATL_SIMPLE_CMDBAR_PANE_STYLE);
// attach menu
m_CmdBar.AttachMenu(GetMenu());
// load command bar images
m_CmdBar.LoadImages(IDR_MAINFRAME);
// remove old menu
SetMenu(NULL);
HWND hWndToolBar = CreateSimpleToolBarCtrl(m_hWnd, IDR_MAINFRAME,
FALSE, ATL_SIMPLE_TOOLBAR_PANE_STYLE);
CreateSimpleReBar(ATL_SIMPLE_REBAR_NOBORDER_STYLE);
AddSimpleReBarBand(hWndCmdBar);
AddSimpleReBarBand(hWndToolBar, NULL, TRUE);
CreateSimpleStatusBar();
m_hWndClient = m_view.Create(m_hWnd, rcDefault, NULL,
WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN,
WS_EX_CLIENTEDGE);
UIAddToolBar(hWndToolBar);
UISetCheck(ID_VIEW_TOOLBAR, 1);
UISetCheck(ID_VIEW_STATUS_BAR, 1);
CMessageLoop* pLoop = _Module.GetMessageLoop();
pLoop->AddMessageFilter(this);
pLoop->AddIdleHandler(this);
return 0;
}
這是從一個(gè)SDI程序拿來(lái)的一段代碼,該程序有一個(gè)基于command bar的工具條和一個(gè)狀態(tài)條. 函數的第一行創(chuàng )建了一個(gè)command bar實(shí)例,然后對它進(jìn)行初始化,在其中加入框架窗口的菜單和工具條位圖. 這段代碼先將菜單取出,把所有的下拉菜單轉換為工具條按鈕,并將菜單保存在一個(gè)變量中,以備后用. 給人的感覺(jué)是菜單是由工具條實(shí)現的-那我們就把它叫做工具條菜單(menu toolbar)吧. 然后Command Bar將程序工具條的圖標裝入image list 并將它們的ID保存在數組中. 當點(diǎn)擊工具條菜單的按鈕時(shí),commandbar會(huì )找到對應的子菜單,創(chuàng )建一個(gè)彈出菜單. Command bar將子菜單項的ID和它保存的ID進(jìn)行比較,這些ID跟image list中的工具條按鈕圖標是相關(guān)聯(lián)的. 如果比較成功, 則將關(guān)聯(lián)的圖標加到菜單項上去. 這意味著(zhù)相同ID的菜單項和工具條按鈕具有相同的圖標.
接下來(lái), 創(chuàng )建工具條并把它關(guān)聯(lián)到commandbar, 然后創(chuàng )建狀態(tài)條和視圖.可以看到視圖的HWND存放在框架窗口的m_hWndClient變量中. 這個(gè)窗口句柄在框架窗口的WM_SIZE handler中會(huì )用到.當框架窗口改變大小時(shí),它告知視圖改變自身,于此同時(shí)也要考慮狀態(tài)條和command bar.
在下來(lái)的三行(從調用UIAddToolBar()開(kāi)始) 用來(lái)顯示在運行時(shí)會(huì )改變狀態(tài)的UI項(UI item).文章后面還會(huì )重提這個(gè)話(huà)題. 最后,訪(fǎng)問(wèn)消息循環(huán)(message loop), 你應該還記得該消息循環(huán)存放在一全局數組中. GetMessageLoop() 取得當前線(xiàn)程的消息循環(huán),加入框架窗口的message filter和idle handler, 分別默認是PreTranslateMessage()和OnIdle().
框架窗口繼承于以下類(lèi):
class CMainFrame :
public CFrameWindowImpl<CMainFrame>,
public CUpdateUI<CMainFrame>,
public CMessageFilter,
public CIdleHandler
后兩個(gè)抽象類(lèi)宣稱(chēng)了框架窗口類(lèi)實(shí)現了PreTranslateMessage()和OnIdle(). 從CUpdateUI<>繼承表示框架類(lèi)支持UI update map.
視圖
視圖窗口看起來(lái)顯得很簡(jiǎn)單:
class CMyView : public CWindowImpl<CMyView>
{
public:
DECLARE_WND_CLASS(NULL)
BOOL PreTranslateMessage(MSG* pMsg)
{
pMsg;
return FALSE;
}
BEGIN_MSG_MAP(CMyView)
MESSAGE_HANDLER(WM_PAINT, OnPaint)
END_MSG_MAP()
LRESULT OnPaint(UINT, WPARAM, LPARAM, BOOL&)
{
CPaintDC dc(m_hWnd);
//TODO: Add your drawing code here
return 0;
}
};
上面是一個(gè)SDI程序的視圖類(lèi). 多線(xiàn)程SDI和MDI的視圖類(lèi)在本質(zhì)上也跟這個(gè)一樣,但他們沒(méi)有PreTranslateMessage()方法. SDI程序就是使用這個(gè)函數,趕在框架類(lèi)處理消息之前把消息抓住. PreTranslateMessage()在SDI的框架類(lèi)中的實(shí)現是,直接將消息轉發(fā)給視圖類(lèi).
這里顯示的視圖實(shí)際上沒(méi)有做什么工作.你應該自己在OnPaint()函數中加入畫(huà)出文檔內容的代碼.如果需要支持輸入,如鼠標的點(diǎn)擊和鍵盤(pán)的按鍵,你應該加入相應消息處理函數到類(lèi)和映射中. 可以看到這個(gè)窗口是從CWindowImpl<>繼承下來(lái)的,如果你想讓它基于一個(gè)Win32控件的話(huà),就應該從定義在A(yíng)tlCtrls.h文件中某個(gè)WTL類(lèi)繼承.
如果想在基于CWindowImpl<>的類(lèi)里加上滾動(dòng)條,那么你應該把基類(lèi)換成CScrollWindowImpl<>,同時(shí)把消息鏈給它:
class CMyView : public CScrollWindowImpl<CMyView>
{
public:
typedef CScrollWindowImpl<CMyView> parent;
BEGIN_MSG_MAP(CMyView)
CHAIN_MSG_MAP(parent)
END_MSG_MAP()
void DoPaint(CDCHandle dc)
{
}
};
基類(lèi)保證窗口具備滾動(dòng)條,并提供滾動(dòng)條消息的默認處理.視圖類(lèi)不再有WM_PAINT的處理函數,因為它已被CScrollWindowImpl<>處理.根據滾動(dòng)條的位置,CScrollWindowImpl<>畫(huà)出視圖相對應的部分. 取而代之的是,在你的類(lèi)里實(shí)現DoPaint(),在這里你需要畫(huà)出整個(gè)視圖.如果你想指定滾動(dòng)的范圍,大小或起點(diǎn),你需要加上處理WM_CREATE消息的函數,把這些初始化代碼放到里邊.
正如我先前所提到的,框架窗口會(huì )改變視圖窗口的大小,以使它客戶(hù)區未被狀態(tài)條和工具條覆蓋的部分為視圖所填充. 在大多數情況下,這樣就夠了.但是當你想要一個(gè)具有Windows Explorer樣子的程序時(shí),該怎么辦呢? Windows Explorer的窗口包含了一個(gè)tree view 和一個(gè)list view,還有兩者之間的分割條. WTL的解決方案很簡(jiǎn)單:使用splitter窗口!
為此你需要改變一下框架窗口,讓它創(chuàng )建splitter窗口的一個(gè)實(shí)例作為它的視圖. 例如, 在你的框架類(lèi)里有如下的數據成員:
CSplitterWindow m_view;
CTreeViewCtrl m_tree;
CListViewCtrl m_list;
你可以在OnCreate()創(chuàng )建一個(gè)splitter窗口:
// get the frame client rect, so that we set the splitter initial size
// and we can get the splitter bar in the centre
RECT rect;
GetClientRect(&rect);
m_hWndClient = m_view.Create(m_hWnd, rect,
NULL, WS_CHILD | WS_VISIBLE);
m_tree.Create(m_view, rcDefault, NULL,
WS_CHILD | WS_VISIBLE | TVS_HASBUTTONS | TVS_HASLINES | TVS_LINESATROOT,
WS_EX_CLIENTEDGE);
m_list.Create(m_view, rcDefault,
NULL, WS_CHILD | WS_VISIBLE | LVS_REPORT, WS_EX_CLIENTEDGE);
m_view.SetSplitterPanes(m_tree, m_list);
m_view.SetSplitterPos();
Splitter窗口如同一個(gè)視圖,將框架窗口作為它的父窗口. 在這段代碼里,我將框架窗口客戶(hù)區的實(shí)際大小傳給了splitter窗口. 我也可以在這里使用 rcDefault,因為一旦框架窗口創(chuàng )建完成,框架窗口就會(huì )轉發(fā)WM_SIZE消息給splitter. 這樣splitter可以馬上改變自身的大小來(lái)填充框架. 然而,當我準備使用不帶參數的SetSplitterPos(),把分割條設置于窗口中線(xiàn)時(shí),出現了問(wèn)題.Splitter窗口使用它的大小來(lái)決定中線(xiàn)的位置,由于rcDefault告訴窗口它的大小是0(因此中線(xiàn)的位置也是0),從而意味著(zhù)分割條將出現在z最左邊,將左窗口隱藏了起來(lái).
創(chuàng )建了splitter窗口后,你需要創(chuàng )建那些你想要分割的窗口了.它們將作為splitter窗口的子窗口被創(chuàng )建.最后你將這些子窗口通過(guò)SetSplitterPanes()加到splitter窗口中去,并確定分割條的位置所在.
UI Update
菜單項可以被設置為有效或無(wú)效,可以帶check記號或著(zhù)像radio按鈕一樣,在一組菜單項中同時(shí)有且只有一個(gè)能被check.此外,菜單項還可以帶圖標和文字. 所有的這些狀態(tài)都可以在運行時(shí)根據程序中的某個(gè)值進(jìn)行改變.工具條在某種程度上可以看做是菜單的易見(jiàn)形態(tài),因為它們的按鈕可以個(gè)別地,或者作為一組的一部分被置成有效或無(wú)效,推入推出. UI update機制允許你指定哪些UI元件(UI element)的狀態(tài)可以在運行時(shí)改變. WTL使用如下的UI update映射來(lái)實(shí)現這一功能:
BEGIN_UPDATE_UI_MAP(CMainFrame)
UPDATE_ELEMENT(ID_FILE_SAVERESULTS, UPDUI_MENUPOPUP | UPDUI_TOOLBAR)
UPDATE_ELEMENT(ID_VIEW_TOOLBAR, UPDUI_MENUPOPUP)
UPDATE_ELEMENT(ID_VIEW_STATUS_BAR, UPDUI_MENUPOPUP)
END_UPDATE_UI_MAP()
這個(gè)例子指出三個(gè)菜單項在運行時(shí)有一個(gè)狀態(tài)需要顯示,其中的一個(gè), ID_FILE_SAVERESULTS,還有一個(gè)工具條按鈕跟它相關(guān)聯(lián). WTL通過(guò)建立一個(gè)數組來(lái)保存這些信息.為此你需要完成兩方面的工作:
首先是UI元件的狀態(tài). 如果是菜單項, 你可以使用UIEnable()使能該菜單項, UISetCheck()設置check記號, UISetText()改變菜單的文字.如果是工具條按鈕,那么你使用UIEnable()使能該按鈕, UISetCheck()或者UISetRadio()決定按鈕是推入還是推出.下邊的代碼根據是否有文本被選中,來(lái)使能Cut菜單項和工具條按鈕:
BOOL bSelected = GetSelected();
UIEnable(ID_EDIT_CUT, bSelected);
你可以把這樣的代碼放入相應處理函數中(如一個(gè)菜單項的狀態(tài)依賴(lài)于另一個(gè)菜單項的動(dòng)作,將它放入后者的處理函數中),或者放入OnIdle()方法,通過(guò)檢查某個(gè)類(lèi)變量來(lái)決定元件的狀態(tài).
其次是確定各個(gè)UI元件是否都被更新了,為此你需要調用CUpdateUI<>的某個(gè)方法將UI元件加入到列表中.主菜單已被自動(dòng)加入,但是其他的任何菜單和所有的工具條必須分別通過(guò)調用UIAddMenuBar()和UIAddToolBar()手動(dòng)加入.
其他還有一堆事情要注意. 首先,設置了工具條的狀態(tài)后,使用UIUpdateToolBar()以使工具條狀態(tài)更新. 對于菜單,你不需如此,因為子菜單是動(dòng)態(tài)生成的.UIUpdateMenuBar()這個(gè)方法也存在,但是它的作用是把菜單恢復到初始狀態(tài),如果你改變過(guò)某些項的文字,調用UIUpdateMenuBar()的結果可能不是你所期望的(因為菜單項的文字會(huì )變成老的).
盡管還有一個(gè)方法UISetRadio(),但是還沒(méi)有一個(gè)把幾個(gè)菜單項或者工具條按鈕當做radio按鈕組(也就是說(shuō),有一個(gè)而且只有一個(gè)被選中)的機制.如果你希望得到這樣效果,你必須自己編碼,不過(guò)它并不難.
對話(huà)框
ATL的對話(huà)框支持一向很好,對此WTL新增了通用對話(huà)框的封裝. 本質(zhì)上是為對話(huà)框加入了輸入驗證和回調函數. 比如, 你想在用戶(hù)改變年Open對話(huà)框中的文件夾時(shí)有所動(dòng)作,那么你應該從CFileDialogImpl<>繼承一個(gè)類(lèi),實(shí)現OnFolderChange():
class CMyFileDialog : public CFileDialogImpl<CMyFileDialog>
{
public:
CMyFileDialog(BOOL b)
: CFileDialogImpl<CMyFileDialog>(b) { }
void OnFolderChange(LPOFNOTIFY lpon)
{
char strFolder[MAX_PATH];
if (GetFolderPath(strFolder, sizeof(strFolder)) > 0)
{
MessageBox(strFolder);
}
}
};
當文件夾的路徑改變時(shí),CFileDialogImpl<>調用OnFolderChange().該函數使用基類(lèi)的GetFolderPath(),來(lái)取得新路徑.
控件
WTL為所有的Win32和通用控件提供了封裝類(lèi),包括Windows 2000新加入的. 雖然只是簡(jiǎn)單的包裝,但是它們使這些控件更加容易訪(fǎng)問(wèn).譬如,你能記清楚從List View讀出當前選定項的文字的消息和需要傳的參數嗎?(實(shí)際上, 你需要發(fā)送兩個(gè)消息, 一個(gè)是得到選定項的索引,另一個(gè)是讀出它的文字.) WTL的作者為你完成了這些煩人的工作, 提供了一個(gè)簡(jiǎn)單的封裝函數供你使用.
使用這些控件類(lèi)有兩種方法. 如果你的對話(huà)框里有一個(gè)控件, 你可以將控件的HWND依附到一個(gè)封裝對象,使用封裝類(lèi)的方法來(lái)訪(fǎng)問(wèn)控件.這種方法簡(jiǎn)化了你讀寫(xiě)控件數據和處理notification消息的代碼.
另外的用法是把這些類(lèi)加到你的視圖類(lèi)的繼承層次中去:
class CMyView : public CWindowImpl<CMyView, CListBox>
這表示CWindowImpl<>是從CListBox繼承而來(lái),因此創(chuàng )建的窗口將是一個(gè)list box (因為窗口類(lèi)的名字是通過(guò)調用
CListBox::GetWndClassName()得到的). 另外, ATL的窗口機制會(huì )子類(lèi)化這個(gè)窗口,將發(fā)給它的消息路由到你的消息映射中去. 它保留了老的窗口函數,這樣,你沒(méi)有處理的消息將由老的窗口函數來(lái)處理.當你的視圖類(lèi)從控件類(lèi)繼承時(shí),WTL就會(huì )使用這一技術(shù).
在notification消息和子類(lèi)化這個(gè)主題上,有一點(diǎn)很值得指出,那就是當某事件發(fā)生時(shí),絕大多數窗口控件都會(huì )發(fā)送notification消息給它們的父窗口.讓你窗口來(lái)處理這些notification消息要比子類(lèi)化一個(gè)已存在控件窗口(或子類(lèi)化一個(gè)已存在的類(lèi),然后建立一個(gè)實(shí)例),從而在控件之前取得消息好得多. 譬如, 你想處理按鈕的click事件,你所需要做的只是處理BN_CLICKED notification.它將由按鈕發(fā)送給你的窗口類(lèi).另外的一種方法是從CContainedWindow<>子類(lèi)化BUTTON窗口來(lái)處理click消息.
我之所以說(shuō)這個(gè)是因為一個(gè)知名的ATL鼓吹者給我一份代碼里就是這么做的.他的代碼取得一個(gè)簡(jiǎn)單的按鈕click事件所花的時(shí)間是別人的3到4倍,因為他子類(lèi)化了按鈕控件,而不是簡(jiǎn)單的處理BN_CLICKED notification.
WTL還提供了一些新的控件,在win32中沒(méi)有對等者. 你已經(jīng)看到過(guò)一個(gè) -- command bar, 實(shí)際上還有其他一些非常有用類(lèi):
類(lèi) 描述
CBitmapButton這是一個(gè)用位圖替代標題的按鈕.你可以提供一個(gè)image list,里邊包含按鈕在正常狀態(tài),失效, 推入和鼠標落在按鈕上的圖表.
CHyperLink讓你建立一個(gè)static控件,它代表一個(gè)hyperlink,這樣當用戶(hù)點(diǎn)擊它時(shí),默認的web瀏覽器打開(kāi)該鏈接.
CWaitCursor這不過(guò)是在它的構造函數中把鼠標圖標改成等待狀態(tài),而在析構函數中還原.
CCheckListViewCtrl在每一項邊上都有一個(gè)check box的list box.
CMultiPaneStatusBarCtrl具有多個(gè)pane的狀態(tài)條