ClassWizard

ClassWizard

ClassWizard的意思就是智能地操作類的工具,通常被稱作“類嚮導”。

簡介


在Visual C++ 6.0的集成開發環境中,ClassWizard最能體現它的特徵。與AppWizard類似,ClassWizard也能自動生成程序代碼,只是兩者生成的對象不同,AppWizard主要用來創建應用程序的框架,而ClassWizard則主要是在應用程序框架的基礎上創建和編輯各種類。
ClassWizard既可以操作由AppWizard在應用程序框架中創建的類,又可以操作後來由ClassWizard自己添加的類。利用ClassWizard可以很輕鬆地完成一些最基本、最普通的工作,如在自己的應用程序中創建新類、映射消息為其添加消息處理函數、覆蓋虛擬函數、將對話框中的控制項與某個變數相關聯等。
ClassWizard只能用於使用MFC類庫的應用程序中。
ClassWizard可以完成的主要功能如下:
◆ 創建新類。這是ClassWizard最基本的用途之一。創建的新類由一些主要的基類派生而來,這些基類用於處理Windows的消息,對一般用戶來說,這些基類已經足夠了。
◆ 進行消息映射。這些消息主要和窗口、菜單、工具欄、對話框、控制項以及加速鍵相關聯。
◆ 添加成員變數。利用ClassWizard,可以很方便地向類中添加成員變數,並將這些成員變數與對話框或窗口中的控制項關聯起來,當控制項的值改變時,所對應的成員變數的值也跟著發生變化。
◆ 覆蓋虛擬函數。使用ClassWizard可以方便地覆蓋基類中定義的虛擬函數。

操作說明


在剛進入Visual C++集成開發環境時,菜單項View|ClassWizard是灰化禁止的,只有在打開一個工作區文件后,該菜單項才能正常顯示,表明該選項是可用的。
首先打開以前創建的多文檔應用程序FirstApp,再選擇菜單項View|ClassWizard,即可啟動ClassWizard,進入ClassWizard環境,ClassWizard是一個對話框,其中包含五個選項卡,分別為:Message Maps、Member Variables、Automation、ActiveX Events、以及Class Info。它們針對不同的對象完成不同的任務。
⒈ Message Maps選項卡
它是ClassWizard對話框中最重要的選項卡,主要完成創建新類、添加、刪除消息處理函數等任務。
該選項卡中包含了兩個下拉列表框:Project下拉列表框和Class name下拉列表框;三個列表框:Object IDs列表框、Message列表框和Member functions列表框;一個文本信息框;四個工具按鈕。
★ Project下拉列表框:該下拉列表框用於選擇當前操作的項目。噹噹前打開的工作區中包含多個項目文件時,用戶可以從這個下拉列表框中選擇將要操作的項目文件。對於單項目工作區來說,其默認值就是項目文件。
★ Class name下拉列表框:該下拉列表框用於選擇當前要操作的類。當用戶在Class name下拉列表框中選中了某個類之後,Object IDs窗口中的內容將會發生相應的變化。
★ Object IDs列表框:該列表框用於顯示當前選定類中能夠產生消息的對象的ID值。這些對象包括菜單選項、工具欄按鈕選項、對話框以及各種控制項等。
通常Object IDs列表框中所包含的第一個對象就是當前類名。
★ Message列表框:Message列表框中列出了對應於Object IDs列表框中所選中的當前項可以處理的消息以及可被重寫的MFC虛函數。當Object IDs列表框中選定當前類名時,Message列表框前部分顯示的是當前類所能覆蓋的虛擬函數,後部分顯示的是能夠處理的消息。如Object IDs列表框中選定其它對象,則Message列表框顯示的就是當前項可以處理的消息。
★ Member functions列表框:Member functions列表框中列出了在Class name下拉列表框中所選中的當前類包含的所有成員函數。其中用字母“V”標出的是MFC虛函數,用字母“W”標出的是Windows消息處理函數。
★ 文本信息框:在Project下拉列表框的下方有一個文本信息框,用於顯示當前選中類的源文件,包括.h文件和.cpp文件。該文本信息框中顯示的內容會隨著選定類的變化而變化。
★ Add Class按鈕:該按鈕用於向當前的Project中添加一個新類,新類可以是自己創建,也可以是從已有的文件中選取。
★ Add Function按鈕:該按鈕用於向當前選定類中為當前選定的消息添加一個消息處理函數。其中類是在Class name下拉列表框中選定的類;而當前消息則是在Message列表框中選定的消息。
Add Function按鈕平時是灰化禁止的,只有當用戶在Message列表框中選中某個特定的消息之後,該按鈕才能正常顯示,即此時才能使用。
★ Delete Function按鈕:該按鈕用於在當前選定的類中刪除已有的成員函數。Delete Function按鈕平時是灰化禁止的,只有當用戶在Member functions列表框中選中某個消息處理函數之後,才能選擇該按鈕。
★ Edit Code按鈕:單擊該按鈕將打開編輯窗口,並將游標位置自動跳到當前選定的成員函數的源代碼處。
⒉ Member Variables選項卡
該選項卡主要用於添加與對話框中的控制項相關聯的成員變數,以便程序能利用這些成員變數與對話框中的控制項進行數據交換。該選項卡與Message Maps選項卡一樣,也包含Project下拉列表框和Class name下拉列表框,分別用於選定用戶操作的當前項目和當前類;Add Class按鈕用於向當前項目中添加一個新類;一個文本信息框,用於顯示當前選中類的源文件。
此外,Member Variables選項卡中還包含另一個列表框以及另外四個工具按鈕。列表框中共有3列數據,分別為:
★ Control IDs:該項顯示了當前選定類中能夠映射成員變數的控制項的ID值。所謂能映射成員變數的控制項,就是可以使用類中的成員變數來代表某個控制項,當控制項發生改變時,該成員變數的值也發生相應變化。
★ Type:該項表示成員變數的類型。
★ Member:該項表示成員變數的名字。
注意:並不是所有的類都有這些信息,只有在選擇了對話框類、有格式視圖類或記錄視圖類時才能顯示出這些信息。
★ Add Variable按鈕:該按鈕用於為當前選定的控制項添加一個成員變數。
★ Delete Variable按鈕:該按鈕用於刪除一個現有的成員變數。該按鈕平時是灰化禁止的,只有當用戶在Control IDs列表框中選中某個成員變數以後,才能選擇該按鈕執行刪除工作。
★ Update Columns按鈕:該按鈕用於選定一個數據源,只在記錄集合類中才可以使用。
★ Bind All按鈕:只適用於記錄集合類,單擊此按鈕將把所有未綁定的記錄集里的數據成員綁定到數據源的一個表中相應的列上。在默認情況下,MFC AppWizard和ClassWizard將綁定所有的列,所以很少需要使用數據綁定。如果通過刪除相關的數據成員將一些或所有列取消綁定,那麼在這之後還可以重新綁定它們。
⒊ Automation選項卡
該選項卡允許用戶加入方法或屬性以增強Automation功能。
⒋ ActiveX Events選項卡
該選項卡允許用戶加入事件以支持ActiveX控制項。
⒌ Class Info選項卡
該選項卡用於顯示和設置當前選定類中的一些重要信息。

創建新類


使用ClassWizard最重要的作用就是創建新類,用戶將不必手工添加創建類所需的大量代碼,只需指定一些關於新類的重要信息,ClassWizard將自動為你生成這些代碼。
下面以應用程序FirstApp為例說明創建過程。步驟如下:
⑴ 首先打開FirstApp的項目工作區。
⑵ 點擊菜單項View|ClassWizard,進入ClassWizard對話框。
⑶ 在Message Maps選項卡中選擇功能按鈕Add Class,並從其下拉選項欄中單擊New選項,將會打開New Class對話框。
⑷ 首先在Name欄中鍵入新類的名稱,如FirstButton。此時我們將看到在下面的File name欄中顯示出ClassWizard自動為新類定義的默認文件名:FirstButton.cpp。如果你不想要這個名字,也可以單擊Change按鈕對文件名進行修改。
⑸ 接下來應當設定新類的基類,即該類是由什麼類派生而來的。在Base class下拉列表框中選中所需的基類名,如CButton。
⑹ 如果你創建的基類需要對話框或其它資源,則應當在Dialog ID框中選擇一個資源ID值。
⑺ Automation組框用於設置類的自動化信息,這隻適用於能夠自動化的類,即由CCmdTarget所派生的類,我們保持其默認選擇None。
⑻ 最後單擊OK按鈕結束。
至此我們已經成功地向項目中添加了一個新類FirstButton。
回到Visual C++的主窗口中,我們將發現在FirstApp的項目工作區中發生了一些變化。打開ClassView選項卡,將看到一個新類FirstButton已經被添加到該項目的類列表中了。同時在FirstView選項卡中將發現FirstApp項目中新增加了兩個文件:FirstButton.h,FirstButton.cpp。

添加函數


使用ClassWizard來為類添加消息處理函數,用戶將不需要手工編寫消息映射所需的各種消息宏,這樣大大減輕了工作量。
本節將以FirstApp應用程序為例來添加消息處理函數,處理用戶在視圖中的單擊滑鼠操作。步驟如下:
⑴ 首先打開FirstApp的項目工作區。
⑵ 點擊菜單項View|ClassWizard,進入ClassWizard對話框。
⑶ 選擇Message Maps選項卡,在Project下拉列表框中選擇項目名FirstApp,在Class name下拉列表框中選擇類名CFirstAppView。
⑷ 在Object IDs列表框中選擇對象ID為CFirstAppView。
⑸ 在Message列表框中選擇需要處理的消息為WM_LBUTTONDOWN,即按下滑鼠左鍵消息。
⑹ 此時會發現Add Function按鈕已經可用。單擊此按鈕,ClassWizard將選中消息的處理函數添加到Member Functions列表框中。在本例中,對應WM_LBUTTONDOWN消息的處理函數是OnLButtonDown()。
⑺ 最後單擊OK按鈕結束。
注意:當用戶為一些標準的Windows消息添加消息處理函數時,ClassWizard一般會自動地為你創建一個默認的消息處理函數名。而當用戶為非標準消息添加處理函數時,ClassWizard將彈出一個對話框,並給出一個預設的函數名,用戶可以重新命名該消息響應函數。
在Visual C++的主窗口中打開項目工作區的ClassView選項卡,並打開CFirstAppView類的成員列表,就會發現消息處理函數OnLButtonDown()已經被添加進去了。
同時,通過查看文件,將會看到在CFirstAppView類的頭文件FirstAppView.h中新加了消息處理函數OnLButtonDown()的聲明。
可以看到該函數體是空的,其中只調用了一個其父類的成員函數,並且ClassView為用戶生成了一些重要的註釋行,以提示用戶在何處添加自己的代碼。

添加變數


成員變數也是類中不可或缺的組成部分,用於保存類的信息,我們將利用ClassView來為類添加成員變數。具體步驟如下:
⑴ 首先打開FirstApp的項目工作區。
⑵ 點擊菜單項View|ClassWizard,進入ClassWizard對話框。
⑶ 在ClassWizard對話框中選擇Member Variables選項卡,在Project下拉列表框中選擇當前項目名FirstApp,在Class name下拉列表框中選擇當前類名CAboutDlg。此時在Controls IDs列表框中將顯示該類中包含的控制項ID:“IDOK”,這個ID值對應於About對話框中的OK按鈕。
⑷ 單擊Add Variables按鈕,將打開Add Member Variables對話框。有3個控制項用來設置新成員變數的一些重要信息。
◆ Member variables name文本框:該文本框用來輸入新成員變數的名字,在默認情況下,ClassWizard提供“m_”這個前綴以便將這個變數確認為成員變數。
◆ Category下拉列表框:該下拉列表框用於指定新變數是一個“Value”類型的成員變數還是一個“Control”類型的成員變數。對於標準的Windows控制項來說,選擇Value可以創建一個包含由用戶來輸入控制項文本和控制項狀態的成員變數。而當用戶選中Control選項時,就可以創建一個“Control”類型的變數,我們可以對這個控制項直接進行訪問。
◆ Variable type下拉列表框:該下拉列表框用於選擇變數的數據類型。
⑸ 在Member variables name欄中輸入變數名m_ok;在Category欄中選擇該變數的類型:copntrol類型;在Variable type欄中選擇該變數的數據類型CButton。
⑹ 單擊OK按鈕退出,這時我們可以看到,ClassWizard對話框中發生了改變。
打開FirstApp程序的項目工作區,可以看到,在CAboutDlg類的數據成員中,新增加了一個成員變數:m_ok。在CAboutDlg類的成員函數DoDataExchange()中,也添加了一條語句來映射控制項ID值IDOK和成員變數m_ok:
DDX_Control(pDX,IDOK,m_ok);

覆蓋函數


我們還可以使用ClassWizard來覆蓋基類中定義的虛擬函數,方法如下:
⑴ 打開ClassWizard對話框的Message Maps選項卡。
⑵ 在Class name下拉列表框中選擇一個類名來作為當前類。如CFirstAppView。
⑶ 在Object Ids列表框中再次選擇該類名,如CFirstAppView。此時在Message列表框中將列出所有可以覆蓋的虛擬函數名和所有可操作的Windows消息。
⑷ 在Message列表框中選擇所要覆蓋的虛擬函數,如OnPaint()。
⑸ 單擊Add Function按鈕覆蓋基類的該虛擬函數。此時在Member functions列表框中將顯示虛擬函數名OnPaint()。注意在此函數前有一個“V”字母,表示該函數是一個虛擬函數。
⑹ 單擊OK按鈕結束。
我們在頭文件FirstAppView.h中可看到該虛擬函數的定義:
virtual void OnPaint(CDC * pDC,CPrintInfo * pInfo);
同時在實現函數FirstAppView.cpp中可看到該虛擬函數的函數體:
void CFirstAppView::OnPaint(CDC * pDC,CPrintInfo * pInfo)
{
//在此處加上專門代碼或調用基類
CView::OnPaint(pDC,pInfo);
}