6.1 傳統(tǒng)控件
在上一課的表5.1已經(jīng)列出了Windows的傳統(tǒng)控件及其對應(yīng)的控件類。在這些控件中，讀者應(yīng)該重點(diǎn)掌握命令按鈕、選擇框、單選按鈕、編輯框、列表框和組合框。
.1.1 傳統(tǒng)控件的控件通知消息
控件通過向父窗口發(fā)送控件通知消息來表明發(fā)生了某種事件．例如，當(dāng)用戶在按鈕上單擊鼠標(biāo)時，按鈕控件會向父窗口發(fā)送BN_CLICKED消息．傳統(tǒng)控件的通知消息實(shí)際上是通過WM_COMMAND消息發(fā)給父窗口的（滾動條除外），在該消息的wParam中含有通知消息碼（如BN_CLICKED）和控件的ID，在lParam中則包含了控件的句柄．
利用ClassWizard可以很容易地為控件通知消息加入消息映射和消息處理函數(shù)，這在上一章中已經(jīng)演示過了．傳統(tǒng)控件的消息映射宏是ON_XXXX，其中XXXX表示通知消息碼，如BN_CLICKED．ON_XXXX消息映射如下所示，該宏有兩個參數(shù)，一個是控件的ID，一個是消息處理函數(shù)名．
ON_XXXX(nID, memberFxn)
消息處理函數(shù)的聲明應(yīng)該有如下形式：
afx_msg void memberFxn( );
例如，某按鈕的BN_CLICKED消息的消息映射及其處理函數(shù)的聲明如下所示
ON_BN_CLICKED(IDC_ADD,OnAdd)
afx_msg void OnAdd( );
有時，為了處理方便，需要把多個ID連續(xù)的控件發(fā)出的相同消息映射到同一個處理函數(shù)上．這就要用到ON_CONTROL_RANGE宏．ON_CONTROL_RANGE消息映射宏的第一個參數(shù)是控件消息碼，第二和第三個參數(shù)分別指明了一組連續(xù)的控件ID中的頭一個和最后一個ID，最后一個參數(shù)是消息處理函數(shù)名。例如，要處理一組單選按鈕發(fā)出的BN_CLICKED消息，相應(yīng)的消息映射如下所示：
ON_CONTROL_RANGE(BN_CLICKED, IDC_FIRST, IDC_LAST, OnRadioClicked)
函數(shù)OnRadioClicked的聲明如下，該函數(shù)比上面的OnAdd多了一個參數(shù)nID以說明發(fā)送通知消息的控件ID．
afx_msg void OnRadioClicked(UINT nID);
ClassWizard
不支持ON_CONTROL_RANGE宏，所以需要手工建立消息映射和消息處理函數(shù)．
| 提示:事實(shí)上，在使用ClassWizard時只要運(yùn)用一個小小的技巧，就可以把不同控件的通知消息映射到同一個處理函數(shù)上，也可以把一個控件的不同通知消息映射到同一個處理函數(shù)上．這個技巧就是在用ClassWizard創(chuàng)建消息處理函數(shù)時，指定相同的函數(shù)名即可．此方法的優(yōu)點(diǎn)在于控件的ID不必是連續(xù)的，缺點(diǎn)是處理函數(shù)沒有nID參數(shù)，因而不能確定是哪一個控件發(fā)送的消息． |
6.1.2 靜態(tài)控件
靜態(tài)控件包括靜態(tài)正文(Static Text)和圖片控件(Picture)。靜態(tài)正文控件用來顯示正文。圖片控件可以顯示位圖、圖標(biāo)、方框和圖元文件，在圖片控件中顯示圖片的好處是不必操心圖片的重繪問題。靜態(tài)控件不能接收用戶的輸入。在上一章中，讀者已經(jīng)用過靜態(tài)正文和組框控件。圖片控件的例子可以在AppWizard創(chuàng)建的IDD_ABOUTBOX對話框模板中找到，在該模板中有一個圖片控件用來顯示圖標(biāo)。
靜態(tài)控件的主要起說明和裝飾作用。MFC的CStatic類封裝了靜態(tài)控件。CStatic類的成員函數(shù)Create負(fù)責(zé)創(chuàng)建靜態(tài)控件，該函數(shù)的聲明為
BOOL Create( LPCTSTR lpszText, DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID = 0xffff );
參數(shù)lpszText指定了控件顯示的正文。dwStyle指定了靜態(tài)控件的風(fēng)格，表6.1顯示了靜態(tài)控件的各種風(fēng)格，dwStyle可將這些風(fēng)格組合起來。rect是一個對RECT或CRect結(jié)構(gòu)的引用，用來說明控件的位置和尺寸。pParentWnd指向父窗口，該參數(shù)不能為NULL。nID則說明了控件的ID。如果創(chuàng)建成功，該函數(shù)返回TRUE，否則返回FALSE．
表
6.1 靜態(tài)控件的風(fēng)格
|
控件風(fēng)格
|
含義
|
|
SS_BLACKFRAME
|
指定一個具有與窗口邊界同色的框（缺省為黑色）。
|
|
SS_BLACKRECT
|
指定一個具有與窗口邊界同色的實(shí)矩形（缺省為黑色）。
|
|
SS_CENTER
|
使顯示的正文居中對齊，正文可以回繞。
|
|
SS_GRAYFRAME
|
指定一個具有與屏幕背景同色的邊框。
|
|
SS_GRAYRECT
|
指定一個具有與屏幕背景同色的實(shí)矩形。
|
|
SS_ICON
|
使控件顯示一個在資源中定義的圖標(biāo)，圖標(biāo)的名字有 Create函數(shù)的lpszText參數(shù)指定。
|
|
SS_LEFT
|
左對齊正文，正文能回繞。
|
|
SS_LEFTNOWORDWRAP
|
左對齊正文，正文不能回繞。
|
|
SS_NOPREFIX
|
使靜態(tài)正文串中的 &不是一個熱鍵提示符。
|
|
SS_NOTIFY
|
使控件能向父窗口發(fā)送鼠標(biāo)事件消息。
|
|
SS_RIGHT
|
右對齊正文，可以回繞。
|
|
SS_SIMPLE
|
使靜態(tài)正文在運(yùn)行時不能被改變并使正文顯示在單行中。
|
|
SS_USERITEM
|
指定一個用戶定義項(xiàng)。
|
|
SS_WHITEFRAME
|
指定一個具有與窗口背景同色的框（缺省為白色）。
|
|
SS_WHITERECT
|
指定一個具有與窗口背景同色的實(shí)心矩形（缺省為白色）。
|
除了上表中的風(fēng)格外，一般還要為控件指定WS_CHILD和WS_VISIBLE窗口風(fēng)格。一個典型的靜態(tài)正文控件的風(fēng)格為WS_CHILD|WS_VISIBLE|SS_LEFT。
對于用對話框模板編輯器創(chuàng)建的靜態(tài)控件，可以在控件的屬性對話框中指定表6.1中列出的控件風(fēng)格。例如，可以在靜態(tài)正文控件的屬性對話框中選擇Simple，這相當(dāng)于指定了SS_SIMPLE風(fēng)格。
Cstatic類主要的成員函數(shù)在表6.2中列出。可以利用CWnd類的成員函數(shù)GetWindowText，SetWindowText和GetWindowTextLength等函數(shù)來查詢和設(shè)置靜態(tài)控件中顯示的正文．
表
6.2 CStatic類的主要成員函數(shù)
|
函數(shù)聲明
|
用途
|
|
HBITMAP SetBitmap( HBITMAP hBitmap );
|
指定要顯示的位圖。
|
|
HBITMAP GetBitmap( ) const;
|
獲取由 SetBitmap指定的位圖。
|
|
HICON SetIcon( HICON hIcon );
|
指定要顯示的圖標(biāo)。
|
|
HICON GetIcon( ) const;
|
獲取由 SetIcon指定的圖標(biāo)。
|
|
HCURSOR SetCursor( HCURSOR hCursor );
|
指定要顯示的光標(biāo)圖片。
|
|
HCURSOR GetCursor( );
|
獲取由 SetCursor指定的光標(biāo)。
|
|
HENHMETAFILE SetEnhMetaFile( HENHMETAFILE hMetaFile );
|
指定要顯示的增強(qiáng)圖元文件。
|
|
HENHMETAFILE GetEnhMetaFile( ) const;
|
獲取由 SetEnhMetaFile指定的圖元文件。
|
靜態(tài)控件較簡單，故這里就不舉例說明了。
6.1.3 按鈕控件
按鈕是指可以響應(yīng)鼠標(biāo)點(diǎn)擊的小矩形子窗口。按鈕控件包括命令按鈕(Pushbutton)、檢查框(Check Box)、單選按鈕(Radio Button)、組框(Group Box)和自繪式按鈕(Owner-draw Button)。命令按鈕的作用是對用戶的鼠標(biāo)單擊作出反應(yīng)并觸發(fā)相應(yīng)的事件，在按鈕中既可以顯示正文，也可以顯示位圖。選擇框控件可作為一種選擇標(biāo)記，可以有選中、不選中和不確定三種狀態(tài)。單選按鈕控件一般都是成組出現(xiàn)的，具有互斥的性質(zhì)，即同組單選按鈕中只能有一個是被選中的。組框用來將相關(guān)的一些控件聚成一組．自繪式按鈕是指由程序而不是系統(tǒng)負(fù)責(zé)重繪的按鈕。
按鈕主要是指命令按鈕、選擇框和單選按鈕。后二者實(shí)際上是一種特殊的按鈕，它們有選擇和未選擇狀態(tài)。當(dāng)一個選擇框處于選擇狀態(tài)時，在小方框內(nèi)會出現(xiàn)一個“√”，當(dāng)單選按鈕處于選擇狀態(tài)時，會在圓圈中顯示一個黑色實(shí)心圓。此外，檢查框還有一種不確定狀態(tài)，這時檢查框呈灰色顯示，不能接受用戶的輸入，以表明控件是無效的或無意義的。
按鈕控件會向父窗口發(fā)出如表6.3所示的控件通知消息。
表6.3 按鈕控件的通知消息
|
消息
|
含義
|
|
BN_CLICKED
|
用戶在按鈕上單擊了鼠標(biāo)。
|
|
BN_DOUBLECLICKED
|
用戶在按鈕上雙擊了鼠標(biāo)。
|
FC
的CButton類封裝了按鈕控件。CButton類的成員函數(shù)Create負(fù)責(zé)創(chuàng)建按鈕控件，該函數(shù)的聲明為
BOOL Create( LPCTSTR lpszCaption, DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );
參數(shù)lpszCaption指定了按鈕顯示的正文。dwStyle指定了按鈕的風(fēng)格，如表6.4所示，dwStyle可以是這些風(fēng)格的組合。rect說明了按鈕的位置和尺寸。pParentWnd指向父窗口，該參數(shù)不能為NULL。nID是按鈕的ID。如果創(chuàng)建成功，該函數(shù)返回TRUE，否則返回FALSE．
表
6.4 按鈕的風(fēng)格
|
控件風(fēng)格
|
含義
|
|
BS_AUTOCHECKBOX
|
同 BS_CHECKBOX，不過單擊鼠標(biāo)時按鈕會自動反轉(zhuǎn)。
|
|
BS_AUTORADIOBUTTON
|
同 BS_RADIOBUTTON，不過單擊鼠標(biāo)時按鈕會自動反轉(zhuǎn)。
|
|
BS_AUTO3STATE
|
同 BS_3STATE，不過單擊按鈕時會改變狀態(tài)。
|
|
BS_CHECKBOX
|
指定在矩形按鈕右側(cè)帶有標(biāo)題的選擇框。
|
|
BS_DEFPUSHBUTTON
|
指定缺省的命令按鈕，這種按鈕的周圍有一個黑框，用戶可以按回車鍵來快速選擇該按鈕。
|
|
BS_GROUPBOX
|
指定一個組框。
|
|
BS_LEFTTEXT
|
使控件的標(biāo)題顯示在按鈕的左邊。
|
|
BS_OWNERDRAW
|
指定一個自繪式按鈕。
|
|
BS_PUSHBUTTON
|
指定一個命令按鈕。
|
|
BS_RADIOBUTTON
|
指定一個單選按鈕，在圓按鈕的右邊顯示正文。
|
|
BS_3STATE
|
同 BS_CHECKBOX，不過控件有三種狀態(tài)：選擇、未選擇和變灰。
|
除了上表中的風(fēng)格外，一般還要為控件指定WS_CHILD、WS_VISIBLE和WS_TABSTOP窗口風(fēng)格，WS_TABSTOP使控件具有Tabstop屬性。創(chuàng)建一個普通按鈕應(yīng)指定的風(fēng)格為WS_CHILD|WS_VISIBLE|WS_TABSTOP。創(chuàng)建一個普通檢查框應(yīng)指定風(fēng)格WS_CHILD|WS_VISIBLE|WS_TABSTOP| BS_AUTOCHECKBOX。創(chuàng)建組中第一個單選按鈕應(yīng)指定風(fēng)格WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_GROUP| BS_AUTORADIOBUTTON，組中其它單選按鈕應(yīng)指定風(fēng)格則不應(yīng)該包括WS_TABSTOP和WS_GROUP。
對于用對話框模板編輯器創(chuàng)建的按鈕控件，可以在控件的屬性對話框中指定表6.4中列出的控件風(fēng)格。例如，在命令按鈕的屬性對話框中選擇Default button，相當(dāng)于指定了BS_DEFPUSHBUTTON。
CButton類的主要的成員函數(shù)有：
UINT GetState( ) const;
該函數(shù)返回按鈕控件的各種狀態(tài)。可以用下列屏蔽值與函數(shù)的返回值相與，以獲得各種信息。
0x0003
。用來獲取檢查框或單選按鈕的狀態(tài)。0表示未選中，1表示被選中，2表示不確定狀態(tài)（僅用于檢查框）。
0x0004
。用來判斷按鈕是否是高亮度顯示的。非零值意味著按鈕是高亮度顯示的。當(dāng)用戶點(diǎn)擊了按鈕并按主鼠標(biāo)左鍵時，按鈕會呈高亮度顯示。
0x0008
。非零值表示按鈕擁有輸入焦點(diǎn)。
void SetState( BOOL bHighlight );
當(dāng)參數(shù)bHeightlight值為TRUE時，該函數(shù)將按鈕設(shè)置為高亮度狀態(tài)，否則，去除按鈕的高亮度狀態(tài)。
int GetCheck( ) const;
返回檢查框或單選按鈕的選擇狀態(tài)。返回值0表示按鈕未被選擇，1表示按鈕被選擇，2表示按鈕處于不確定狀態(tài)（僅用于檢查框）。
void SetCheck( int nCheck );
設(shè)置檢查框或單選按鈕的選擇狀態(tài)。參數(shù)nCheck值的含義與GetCheck返回值相同。
UINT GetButtonStyle( ) const;
獲得按鈕控件的BS_XXXX風(fēng)格。
void SetButtonStyle( UINT nStyle, BOOL bRedraw = TRUE );
設(shè)置按鈕的風(fēng)格。參數(shù)nStyle指定了按鈕的風(fēng)格。bRedraw為TRUE則重繪按鈕，否則就不重繪。
HBITMAP SetBitmap( HBITMAP hBitmap );
設(shè)置按鈕顯示的位圖。參數(shù)hBitmap指定了位圖的句柄。該函數(shù)還會返回按鈕原來的位圖。
HBITMAP GetBitmap( ) const;
返回以前用SetBitmap設(shè)置的按鈕位圖。
HICON SetIcon( HICON hIcon );
設(shè)置按鈕顯示的圖標(biāo)。參數(shù)hIcon指定了圖標(biāo)的句柄。該函數(shù)還會返回按鈕原來的圖標(biāo)。
HICON GetIcon( ) const;
返回以前用SetIcon設(shè)置的按鈕圖標(biāo)。
HCURSOR SetCursor( HCURSOR hCursor );
設(shè)置按鈕顯示的光標(biāo)圖。參數(shù)hCursor指定了光標(biāo)的句柄。該函數(shù)還會返回按鈕原來的光標(biāo)。
HCURSOR GetCursor( );
返回以前用GetCursor設(shè)置的光標(biāo)。
另外，可以使用下列的一些與按鈕控件有關(guān)的CWnd成員函數(shù)來設(shè)置或查詢按鈕的狀態(tài)。用這些函數(shù)的好處在于不必構(gòu)建按鈕控件對象，只要知道按鈕的ID，就可以直接設(shè)置或查詢按鈕。
void CheckDlgButton( int nIDButton, UINT nCheck );
用來設(shè)置按鈕的選擇狀態(tài)。參數(shù)nIDButton指定了按鈕的ID。nCheck的值0表示按鈕未被選擇，1表示按鈕被選擇，2表示按鈕處于不確定狀態(tài)。
void CheckRadioButton( int nIDFirstButton, int nIDLastButton, int nIDCheckButton );
用來選擇組中的一個單選按鈕。參數(shù)nIDFirstButton指定了組中第一個按鈕的ID，nIDLastButton指定了組中最后一個按鈕的ID，nIDCheckButton指定了要選擇的按鈕的ID。
int GetCheckedRadioButton( int nIDFirstButton, int nIDLastButton );
該函數(shù)用來獲得一組單選按鈕中被選中按鈕的ID。參數(shù)nIDFirstButton說明了組中第一個按鈕的ID，nIDLastButton說明了組中最后一個按鈕的ID。
UINT IsDlgButtonChecked( int nIDButton ) const;
返回檢查框或單選按鈕的選擇狀態(tài)。返回值0表示按鈕未被選擇，1表示按鈕被選擇，2表示按鈕處于不確定狀態(tài)（僅用于檢查框）。
可以調(diào)用CWnd成員函數(shù)GetWindowText，GetWindowTextLength和SetWindowText來查詢或設(shè)置按鈕中顯示的正文．
MFC還提供了CButton的派生類CBitmapButton。利用該類可以創(chuàng)建一個擁有四幅位圖的命令按鈕，按鈕在不同狀態(tài)時會顯示不同的位圖，這樣可以使界面顯得生動活潑。如果讀者對CBitmapButton感興趣，可以參看VC5.0隨盤提供的MFC例子CTRLTEST。
在上一章的Register例子中已演示了各種按鈕控件的使用，故這里就不再舉例了。
6.1.4 編輯框控件
編輯框(Edit Box)控件實(shí)際上是一個簡易的正文編輯器，用戶可以在編輯框中輸入并編輯正文。編輯框既可以是單行的，也可以是多行的，多行編輯框是從零開始編行號的．在一個多行編輯框中，除了最后一行外，每一行的結(jié)尾處都有一對回車換行符（用＂\r\n＂表示）．這對回車換行符是正文換行的標(biāo)志，在屏幕上是不可見的．
編輯框控件會向父窗口發(fā)出如表6.5所示的控件通知消息。
表6.5
|
消息
|
含義
|
|
EN_CHANGE
|
編輯框的內(nèi)容被用戶改變了。與 EN_UPDATE不同，該消息是在編輯框顯示的正文被刷新后才發(fā)出的。
|
|
EN_ERRSPACE
|
編輯框控件無法申請足夠的動態(tài)內(nèi)存來滿足需要。
|
|
EN_HSCROLL
|
用戶在水平滾動條上單擊鼠標(biāo)。
|
|
EN_KILLFOCUS
|
編輯框失去輸入焦點(diǎn)。
|
|
EN_MAXTEXT
|
輸入的字符超過了規(guī)定的最大字符數(shù)。在沒有 ES_AUTOHSCROLL或ES_AUTOVSCROLL的編輯框中，當(dāng)正文超出了編輯框的邊框時也會發(fā)出該消息。
|
|
EN_SETFOCUS
|
編輯框獲得輸入焦點(diǎn)。
|
|
EN_UPDATE
|
在編輯框準(zhǔn)備顯示改變了的正文時發(fā)送該消息。
|
|
EN_VSCROLL
|
用戶在垂直滾動條上單擊鼠標(biāo)。
|
MFC的CEdit類封裝了編輯框控件。CEdit類的成員函數(shù)Create負(fù)責(zé)創(chuàng)建按鈕控件，該函數(shù)的聲明為
BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );
參數(shù)dwStyle指定了編輯框控件風(fēng)格，如表6.6所示，dwStyle可以是這些風(fēng)格的組合。rect指定了編輯框的位置和尺寸。pParentWnd指定了父窗口，不能為NULL。編輯框的ID由nID指定。如果創(chuàng)建成功，該函數(shù)返回TRUE，否則返回FALSE．
表6.6 編輯框控件的風(fēng)格
|
控件風(fēng)格
|
含義
|
|
ES_AUTOHSCROLL
|
當(dāng)用戶在行尾鍵入一個字符時，正文將自動向右滾動 10個字符，當(dāng)用戶按回車鍵時，正文總是滾向左邊。
|
|
ES_AUTOVSCROLL
|
當(dāng)用戶在最后一個可見行按回車鍵時，正文向上滾動一頁。
|
|
ES_CENTER
|
在多行編輯框中使正文居中。
|
|
ES_LEFT
|
左對齊正文。
|
|
ES_LOWERCASE
|
把用戶輸入的字母統(tǒng)統(tǒng)轉(zhuǎn)換成小寫字母。
|
|
ES_MULTILINE
|
指定一個多行編輯器。若多行編輯器不指定 ES_AUTOHSCROLL風(fēng)格，則會自動換行，若不指定ES_AUTOVSCROLL，則多行編輯器會在窗口中正文裝滿時發(fā)出警告聲響。
|
|
ES_NOHIDESEL
|
缺省時，當(dāng)編輯框失去輸入焦點(diǎn)后會隱藏所選的正文，當(dāng)獲得輸入焦點(diǎn)時又顯示出來。設(shè)置該風(fēng)格可禁止這種缺省行為。
|
|
ES_OEMCONVERT
|
使編輯框中的正文可以在 ANSI字符集和OEM字符集之間相互轉(zhuǎn)換。這在編輯框中包含文件名時是很有用的。
|
|
ES_PASSWORD
|
使所有鍵入的字符都用“ *”來顯示。
|
|
ES_RIGHT
|
右對齊正文。
|
|
ES_UPPERCASE
|
把用戶輸入的字母統(tǒng)統(tǒng)轉(zhuǎn)換成大寫字母。
|
|
ES_READONLY
|
將編輯框設(shè)置成只讀的。
|
|
ES_WANTRETURN
|
使多行編輯器接收回車鍵輸入并換行。如果不指定該風(fēng)格，按回車鍵會選擇缺省的命令按鈕，這往往會導(dǎo)致對話框的關(guān)閉。
|
除了上表中的風(fēng)格外，一般還要為控件指定WS_CHILD、WS_VISIBLE、WS_TABSTOP和WS_BORDER窗口風(fēng)格，WS_BORDER使控件帶邊框。創(chuàng)建一個普通的單行編輯框應(yīng)指定風(fēng)格為WS_CHILD|WS_VISIBLE|WS_TABSTOP |WS_BORDER|ES_LEFT|ES_AUTOHSCROLL，這將創(chuàng)建一個帶邊框、左對齊正文、可水平滾動的單行編輯器。要創(chuàng)建一個普通多行編輯框，還要附加ES_MULTILINE|ES_WANTRETURN|ES_AUTOVSCROLL |WS_HSCROLL| WS_VSCROLL風(fēng)格，這將創(chuàng)建一個可水平和垂直滾動的，帶有水平和垂直滾動條的多行編輯器。
對于用對話框模板編輯器創(chuàng)建的編輯框控件，可以在控件的屬性對話框中指定表6.6中列出的控件風(fēng)格。例如，在屬性對話框中選擇Multi-line項(xiàng)，相當(dāng)與指定了ES_MULTILINE風(fēng)格。
編輯框支持剪貼板操作。CEdit類提供了一些與剪貼板有關(guān)的成員函數(shù)，如表6.7所示。
表6.7 與剪切板有關(guān)的CEdit成員函數(shù)
|
函數(shù)聲明
|
用途
|
|
void Clear( )
|
清除編輯框中被選擇的正文。
|
|
void Copy( )
|
把在編輯框中選擇的正文拷貝到剪貼板中。
|
|
void Cut( )
|
清除編輯框中被選擇的正文并把這些正文拷貝到剪貼板中。
|
|
void Paste( )
|
將剪貼板中的正文插入到編輯框的當(dāng)前插入符處。
|
|
BOOL Undo( )
|
撤消上一次鍵入。對于單行編輯框，該函數(shù)總返回 TRUE，對于多行編輯框，返回TRUE表明操作成功，否則返回FALSE。
|
可以用下列CEdit或CWnd類的成員函數(shù)來查詢編輯框。在學(xué)習(xí)下面的函數(shù)時，讀者會經(jīng)常遇到術(shù)語字符索引．字符的字符索引是指從編輯框的開頭字符開始的字符編號，它是從零開始編號的．也就是說，字符索引實(shí)際上是指當(dāng)把整個編輯正文看作一個字符串?dāng)?shù)組時，該字符所在的數(shù)組元素的下標(biāo)．
int GetWindowText( LPTSTR lpszStringBuf, int nMaxCount ) const;
void GetWindowText( CString& rString ) const;
這兩個函數(shù)均是CWnd類的成員函數(shù)，可用來獲得窗口的標(biāo)題或控件中的正文。第一個版本的函數(shù)用lpszStringBuf參數(shù)指向的字符串?dāng)?shù)組作為拷貝正文的緩沖區(qū)，參數(shù)nMaxCount可以拷貝到緩沖區(qū)中的最大字符數(shù)，該函數(shù)返回以字節(jié)為單位的實(shí)際拷貝字符數(shù)（不包括結(jié)尾的空字節(jié)）。第二個版本的函數(shù)用一個CString對象作為緩沖區(qū)。
int GetWindowTextLength( ) const;
CWnd
的成員函數(shù)，可用來獲得窗口的標(biāo)題或控件中的正文的長度。
DWORD GetSel( ) const;
void GetSel( int& nStartChar, int& nEndChar ) const;
兩個函數(shù)都是CEdit的成員函數(shù)，用來獲得所選正文的位置。GetSel的第一個版本返回一個DWORD值，其中低位字說明了被選擇的正文開始處的字符索引，高位字說明了選擇的正文結(jié)束處的后面一個字符的字符索引，如果沒有正文被選擇，那么返回的低位和高位字節(jié)都是當(dāng)前插入符所在字符的字符索引。GetSel的第二個版本的兩個參數(shù)是兩個引用，其含義與第一個版本函數(shù)返回值的低位和高位字相同。
int LineFromChar( int nIndex =
–1 ) const;
CEdit的成員函數(shù)，僅用于多行編輯框，用來返回指定字符索引所在行的行索引（從零開始編號）。參數(shù)nIndex指定了一個字符索引，如果nIndex是-1，那么函數(shù)將返回選擇正文的第一個字符所在行的行號，若沒有正文被選擇，則該函數(shù)會返回當(dāng)前的插入符所在行的行號。
int LineIndex( int nLine =
–1 ) const;
CEdit的成員函數(shù)，僅用于多行編輯框，用來獲得指定行的開頭字符的字符索引，如果指定行超過了編輯框中的最大行數(shù)，該函數(shù)將返回-1。參數(shù)nLine是指定了從零開始的行索引，如果它的值為-1，則函數(shù)返回當(dāng)前的插入符所在行的字符索引。
int GetLineCount( ) const;
CEdit
的成員函數(shù)，僅用于多行編輯框，用來獲得正文的行數(shù)。如果編輯框是空的，那么該函數(shù)的返回值是1。
int LineLength( int nLine =
–1 ) const;
CEdit的成員函數(shù)，用于獲取指定字符索引所在行的字節(jié)長度（行尾的回車和換行符不計(jì)算在內(nèi)）。參數(shù)nLine說明了字符索引．如果nLine的值為-1，則函數(shù)返回當(dāng)前行的長度（假如沒有正文被選擇），或選擇正文占據(jù)的行的字符總數(shù)減去選擇正文的字符數(shù)（假如有正文被選擇）。若用于單行編輯框，則函數(shù)返回整個正文的長度。
int GetLine( int nIndex, LPTSTR lpszBuffer ) const;
int GetLine( int nIndex, LPTSTR lpszBuffer, int nMaxLength ) const;
CEdit
的成員函數(shù)，僅用于多行編輯框，用來獲得指定行的正文（不包括行尾的回車和換行符）。參數(shù)nIndex是行號，lpszBuffer指向存放正文的緩沖區(qū)，nMaxLength規(guī)定了拷貝的最大字節(jié)數(shù)，若。函數(shù)返回實(shí)際拷貝的字節(jié)數(shù)，若指定的行號大于編輯框的實(shí)際行數(shù)，則函數(shù)返回0。需要注意的是，GetLine函數(shù)不會在緩沖區(qū)中字符串的末尾加字符串結(jié)束符(NULL)．
下列CWnd或CEdit類的成員函數(shù)可用來修改編輯框控件。
void SetWindowText( LPCTSTR lpszString );
CWnd
的成員函數(shù)，可用來設(shè)置窗口的標(biāo)題或控件中的正文。參數(shù)lpszString可以是一個CString對象，或是一個指向字符串的指針。
void SetSel( DWORD dwSelection, BOOL bNoScroll = FALSE );
void SetSel( int nStartChar, int nEndChar, BOOL bNoScroll = FALSE );
CEdit
的成員函數(shù)，用來選擇編輯框中的正文。參數(shù)dwSelection的低位字說明了選擇開始處的字符索引，高位字說明了選擇結(jié)束處的字符索引。如果低位字為0且高位字節(jié)為-1，那么就選擇所有的正文，如果低位字節(jié)為-1，則取消所有的選擇．參數(shù)bNoScroll的值如果是FALSE，則滾動插入符并使之可見，否則就不滾動．參數(shù)nStartChar和nEndChar的含義與參數(shù)dwSelection的低位字和高位字相同．
void ReplaceSel( LPCTSTR lpszNewText, BOOL bCanUndo = FALSE );
CEdit
的成員函數(shù)，用來將所選正文替換成指定的正文．參數(shù)lpszNewText指向用來替換的字符串．參數(shù)bCanUndo的值為TRUE說明替換是否可以被撤消的．
在調(diào)用上述函數(shù)時，如果涉及的是一個多行編輯框，那么除了LineLength和GetLine函數(shù)外，都要把回車和換行符考慮在內(nèi)．例如，假設(shè)在編輯框中有如下幾行正文：
abcd
efg
ij
那么字母＂e＂的字符索引是6而不是4，因?yàn)椋?/font>abcd＂后面還有一對回車換行符．調(diào)用LineLength(7)會返回第二行的長度3．調(diào)用LineIndex(2)會得到11．調(diào)用LineFromChar(8)會返回1．如果沒有選擇任何正文，并且插入符在字母＂e＂上，那么調(diào)用GetSel返回值的低位和高位字都是6．
通過分析上述函數(shù)，我們可以總結(jié)出一些查詢和設(shè)置編輯框的方法．
調(diào)用CWnd的成員函數(shù)GetWindowText和SetWindowText可以查詢和設(shè)置編輯框的整個正文，在上一章的Register程序中，我們就使用過這兩個函數(shù)．
如果想對多行編輯框逐行查詢，那么應(yīng)該先調(diào)用GetLineCount獲得總行數(shù)，然后再調(diào)用GetLine來獲取每一行的正文．下面一段代碼演示了如何對多行編輯框進(jìn)行逐行查詢．
char buf[40];
int total=MyEdit.GetLineCount();
int i,length;
for(i=0;i<total;i++)
{
length=MyEdit.GetLine(i,buf,39);
buf[length]=0; //
加字符串結(jié)束符
. . . . . .
}
可以利用
LineIndex和LineFromChar來在字符索引和字符的行列坐標(biāo)之間相互轉(zhuǎn)換．下列代碼演示了在已知字符索引的情況下，如何獲得對應(yīng)的行列坐標(biāo)：
int row,column;
row=MyEdit.LineFromChar(charIndex);
column=charIndex-MyEdit.LineIndex(row);
下列代碼演示了在已知字符的行列坐標(biāo)的情況下，如何獲得對應(yīng)的字符索引：
int charIndex;
charIndex=MyEdit.LineIndex(row)+column;
不難看出字符索引與對應(yīng)的行列坐標(biāo)的關(guān)系是：字符索引=LineIndex(行坐標(biāo))+列坐標(biāo)．
對于選擇正文的查詢和設(shè)置，應(yīng)該利用函數(shù)
GetSel、SetSel和ReplaceSel．
可以利用
GetSel和SetSel來查詢和設(shè)置插入符的位置．SetSel可以使編輯框滾動到插入符的新位置．
要獲取插入符的行列坐標(biāo)，可用下面的代碼實(shí)現(xiàn)：
MyEdit.SetSel(-1,0); //取消正文的選擇
int start,end,row,column;
MyEdit.GetSel(start,end); //start或end的值就是插入符的字符索引
row=MyEdit.LineFromChar(start); //獲取插入符的行坐標(biāo)
column=start-MyEdit.LineIndex(row); //獲取插入符的列坐標(biāo)
下面的代碼演示了如何把插入符移到指定的行和列：
MyEdit.SetSel(-1,0); //取消正文的選擇
int charIndex=MyEdit.LineIndex(row)+column;
MyEdit.SetSel(charIndex,charIndex);
可以利用
ReplaceSel函數(shù)在 插入符處插入正文，典型的代碼如下所示：
MyEdit.SetSel(-1,0); //取消正文的選擇
MyEdit.ReplaceSel(“......”);
可以利用
ReplaceSel清除編輯框中的正文，典型的代碼如下所示：
MyEdit.SetSel(0,-1); //選擇全部正文
MyEdit.ReplaceSel(“”);
在后面的小節(jié)中，讀者將會看到使用編輯框的例子．
.1.5 滾動條控件
滾動條(Scroll Bar)主要用來從某一預(yù)定義值范圍內(nèi)快速有效地進(jìn)行選擇．滾動條分垂直滾動條和水平滾動條兩種．在滾動條內(nèi)有一個滾動框，用來表示當(dāng)前的值．用鼠標(biāo)單擊滾動條，可以使?jié)L動框移動一頁或一行，也可以直接拖動滾動框．滾動條既可以作為一個獨(dú)立控件存在，也可以作為窗口、列表框和組合框的一部分．Windows 95的滾動條支持比例滾動框，即用滾動框的大小來反映頁相對于整個范圍的大小．Windows 3.x使用單獨(dú)的滾動條控件來調(diào)整調(diào)色板、鍵盤速度以及鼠標(biāo)靈敏度，在Windows 95中，滾動條控件被軌道條取代（參見6.2.3）不提倡使用單獨(dú)的滾動條控件．
需要指出的是，從性質(zhì)上劃分，滾動條可分為標(biāo)準(zhǔn)滾動條和滾動條控件兩種．標(biāo)準(zhǔn)滾動條是由WS_HSCROLL或WS_VSCROLL風(fēng)格指定的，它不是一個實(shí)際的窗口，而是窗口的一個組成部分（例如列表框中的滾動條），只能位于窗口的右側(cè)（垂直滾動條）或底端（水平滾動條）．標(biāo)準(zhǔn)滾動條是在窗口的非客戶區(qū)中創(chuàng)建的．與之相反，滾動條控件并不是窗口的一個零件，而是一個實(shí)際的窗口，可以放置在窗口客戶區(qū)的任意地方，它既可以獨(dú)立存在，也可以與某一個窗口組合，行使?jié)L動窗口的職能．由于滾動條控件是一個獨(dú)立窗口，因此可以擁有輸入焦點(diǎn)，可以響應(yīng)光標(biāo)控制鍵，如PgUp、PgDown、Home和End．
MFC
的CScrollBar類封裝了滾動條控件．CScrollBar類的Create成員函數(shù)負(fù)責(zé)創(chuàng)建控件，該函數(shù)的聲明為
BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );
參數(shù)dwStyle指定了控件的風(fēng)格．rect說明了控件的位置和尺寸．pParentWnd指向父窗口，該參數(shù)不能為NULL。nID則說明了控件的ID。如果創(chuàng)建成功，該函數(shù)返回TRUE，否則返回FALSE．
要創(chuàng)建一個普通的水平滾動條控件，應(yīng)指定風(fēng)格WS_CHILD|WS_VISIBLE|BS_HORZ．要創(chuàng)建一個普通的垂直滾動條控件，應(yīng)指定風(fēng)格WS_CHILD|WS_VISIBLE|BS_VERT．
主要的CScrollBar類成員函數(shù)如下所示：
int GetScrollPos( ) const;
該函數(shù)返回滾動框的當(dāng)前位置．若操作失敗則返回0．
int SetScrollPos( int nPos, BOOL bRedraw = TRUE );
該函數(shù)將滾動框移動到指定位置．參數(shù)nPos指定了新的位置．參數(shù)bRedraw表示是否需要重繪滾動條，如果為TRUE，則重繪之．函數(shù)返回滾動框原來的位置．若操作失敗則返回0．
void GetScrollRange( LPINT lpMinPos, LPINT lpMaxPos ) const;
該函數(shù)對滾動條的滾動范圍進(jìn)行查詢．參數(shù)lpMinPos和lpMaxPos分別指向滾動范圍的最小最大值．
void SetScrollRange( int nMinPos, int nMaxPos, BOOL bRedraw = TRUE );
該函數(shù)用于指定滾動條的滾動范圍．參數(shù)nMinPos和nMaxPos分別指定了滾動范圍的最小最大值．由這兩者指定的滾動范圍不得超過32767．當(dāng)兩者都為0時，滾動條將被隱藏．參數(shù)bRedraw表示是否需要重繪滾動條，如果為TRUE，則重繪之．
BOOL GetScrollInfo( LPSCROLLINFO lpScrollInfo, UINT nMask );
該函數(shù)用來獲取滾動條的各種狀態(tài)，包括滾動范圍、滾動框的位置和頁尺寸．參數(shù)lpScrollInfo指向一個SCROLLINFO結(jié)構(gòu)，該結(jié)構(gòu)如下所示：
typedef struct tagSCROLLINFO {
UINT cbSize; //結(jié)構(gòu)的尺寸（字節(jié)為單位）
UINT fMask; /*說明結(jié)構(gòu)中的哪些參數(shù)是有效的，可以是屏蔽值的組合， 如SIF_POS|SIF_PAGE，若為SIF_ALL則整個結(jié)構(gòu)都有效*/
int nMin; //滾動范圍最大值，當(dāng)fMask中包含SIF_RANGE時有效
int nMax; //滾動范圍最小值，當(dāng)fMask中包含SIF_RANGE時有效
UINT nPage; /*頁尺寸，用來確定比例滾動框的大小，當(dāng)fMask中包含 SIF_PAGE時有效*/
int nPos; //滾動框的位置，當(dāng)fMask中包含SIF_POS有效
int nTrackPos; /*拖動時滾動框的位置，當(dāng)fMask中包含 SIF_TRACKPOS時有效，該參數(shù)只能查詢，不能設(shè) 置，最好不要用該參數(shù)來查詢拖動時滾動框的位置*/
} SCROLLINFO;
typedef SCROLLINFO FAR *LPSCROLLINFO;
參數(shù)nMask的意義與SCROLLINFO結(jié)構(gòu)中的fMask相同．函數(shù)在獲得有效值后返回TRUE，否則返回FALSE．
BOOL SetScrollInfo( LPSCROLLINFO lpScrollInfo, BOOL bRedraw = TRUE );
該函數(shù)用于設(shè)置滾動條的各種狀態(tài)，一個重要用途是設(shè)定頁尺寸從而實(shí)現(xiàn)比例滾動框．參數(shù)lpScrollInfo指向一個SCROLLINFO結(jié)構(gòu)，參數(shù)bRedraw表示是否需要重繪滾動條，如果為TRUE，則重繪之．若操作成功，該函數(shù)返回TRUE，否則返回FALSE．
CWnd類也提供了一些函數(shù)來查詢和設(shè)置所屬的標(biāo)準(zhǔn)滾動條．這些函數(shù)與CScrollBar類的函數(shù)同名，且功能相同，但每個函數(shù)都多了一個參數(shù)，用來選擇滾動條．例如，CWnd:: GetScrollPos 的聲明為
int GetScrollPos( int nBar ) const;
參數(shù)nBar用來選擇滾動條，可以為下列值：
SB_HORZ //指定水平滾動條
SB_VERT //指定垂直滾動條
無論是標(biāo)準(zhǔn)滾動條，還是滾動條控件，滾動條的通知消息都是用WM_HSCROLL和WM_VSCROLL消息發(fā)送出去的．對這兩個消息的確省處理函數(shù)是CWnd::OnHScroll和CWnd::OnVScroll，它們幾乎什么也不做．一般需要在派生類中對這兩個函數(shù)從新設(shè)計(jì)，以實(shí)現(xiàn)滾動功能．這兩個函數(shù)的聲明為
afx_msg void OnHScroll( UINT nSBCode, UINT nPos, CScrollBar* pScrollBar );
afx_msg void OnVScroll( UINT nSBCode, UINT nPos, CScrollBar* pScrollBar );
參數(shù)nSBCode是通知消息碼，如表6.8所示．nPos是滾動框的位置，只有在nSBCode為SB_THUMBPOSITION或SB_THUMBTRACK時，該參數(shù)才有意義．如果通知消息是滾動條控件發(fā)來的，那么pScrollBar是指向該控件的指針，如果是標(biāo)準(zhǔn)滾動條發(fā)來的，則pScrollBar為NULL．
表6.8 滾動條的通知消息碼
|
消息
|
含義
|
|
SB_BOTTOM / SB_RIGHT （二者的消息碼是一樣的，因此可以混用，下同）
|
滾動到底端（右端）．
|
|
SB_TOP / SB_LEFT
|
滾動到頂端（左端）．
|
|
SB_LINEDOWN / SB_LINERIGHT
|
向下（向右）滾動一行（列）．
|
|
SB_LINEUP / SB_LINELEFT
|
向上（向左）滾動一行（列）．
|
|
SB_PAGEDOWN / SB_PAGERIGHT
|
向下（向右）滾動一頁．
|
|
SB_PAGEUP / SB_PAGELEFT
|
向上（向左）滾動一頁．
|
|
SB_THUMBPOSITION
|
滾動到指定位置．
|
|
SB_THUMBTRACK
|
滾動框被拖動．可利用該消息來跟蹤對滾動框的拖動．
|
|
SB_ENDSCROLL
|
滾動結(jié)束．
|
6.1.8
小節(jié)的例子中，讀者將學(xué)會如何使用滾動條以及如何編寫自己的OnHScroll函數(shù)．
6.1.6 列表框控件
列表框主要用于輸入，它允許用戶從所列出的表項(xiàng)中進(jìn)行單項(xiàng)或多項(xiàng)選擇，被選擇的項(xiàng)呈高亮度顯示．列表框具有邊框，并且一般帶有一個垂直滾動條．列表框分單選列表框和多重選擇列表框兩種．單選列表框一次只能選擇一個列表項(xiàng)，而多重選擇列表框可以進(jìn)行多重選擇．對于列表項(xiàng)的選擇，微軟公司有如下建議：
單擊鼠標(biāo)選擇一個列表項(xiàng)，單擊一個按鈕來處理選擇的項(xiàng)．
雙擊鼠標(biāo)選擇一個列表項(xiàng)是處理選擇項(xiàng)的快捷方法．
列表框會向父窗口發(fā)送如表6.9所示的通知消息．
表6.9 列表框控件的通知消息
|
消息
|
含義
|
|
LBN_DBLCLK
|
用戶用鼠標(biāo)雙擊了一列表項(xiàng)．只有具有 LBS_NOTIFY的列表框才能發(fā)送該消息．
|
|
LBN_ERRSPACE
|
列表框不能申請足夠的動態(tài)內(nèi)存來滿足需要．
|
|
LBN_KILLFOCUS
|
列表框失去輸入焦點(diǎn)．
|
|
LBN_SELCANCEL
|
當(dāng)前的選擇被取消．只有具有 LBS_NOTIFY的列表框才能發(fā)送該消息．
|
|
LBN_SELCHANGE
|
單擊鼠標(biāo)選擇了一列表項(xiàng)．只有具有 LBS_NOTIFY的列表框才能發(fā)送該消息．
|
|
LBN_SETFOCUS
|
列表框獲得輸入焦點(diǎn)．
|
|
WM_CHARTOITEM
|
當(dāng)列表框收到 WM_CHAR消息后，向父窗口發(fā)送該消息．只有具有LBS_WANTKEYBOARDINPUT風(fēng)格的列表框才會發(fā)送該消息．
|
|
WM_VKEYTOITEM
|
當(dāng)列表框收到 WM_KEYDOWN消息后，向父窗口發(fā)送該消息．只有具有LBS_WANTKEYBOARDINPUT風(fēng)格的列表框才會發(fā)送該消息．
|
MFC的CListBox類封裝了列表框．CListBox類的Create成員函數(shù)負(fù)責(zé)列表框的創(chuàng)建，該函數(shù)的聲明是
BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );
參數(shù)dwStyle指定了列表框控件的風(fēng)格，如表6.10所示，dwStyle可以是這些風(fēng)格的組合．rect說明了控件的位置和尺寸．pParentWnd指向父窗口，該參數(shù)不能為NULL。nID則說明了控件的ID。如果創(chuàng)建成功，該函數(shù)返回TRUE，否則返回FALSE．
表6.10 列表框控件的風(fēng)格
|
控件風(fēng)格
|
含義
|
|
LBS_EXTENDEDSEL
|
支持多重選擇．在點(diǎn)擊列表項(xiàng)時按住 Shift鍵或Ctrl鍵即可選擇多個 項(xiàng)．
|
|
LBS_HASSTRINGS
|
指定一個含有字符串的自繪式列表框．
|
|
LBS_MULTICOLUMN
|
指定一個水平滾動的多列列表框，通過調(diào)用 CListBox::SetColumnWidth來設(shè)置每列的寬度．
|
|
LBS_MULTIPLESEL
|
支持多重選擇．列表項(xiàng)的選擇狀態(tài)隨著用戶對該項(xiàng)單擊或雙擊鼠標(biāo)而翻轉(zhuǎn)．
|
|
LBS_NOINTEGRALHEIGHT
|
列表框的尺寸由應(yīng)用程序而不是 Windows指定．通常，Windows指定尺寸會使列表項(xiàng)的某些部分隱藏起來．
|
|
LBS_NOREDRAW
|
當(dāng)選擇發(fā)生變化時防止列表框被更新，可發(fā)送 WM_SETREDRAW來改變該風(fēng)格．
|
|
LBS_NOTIFY
|
當(dāng)用戶單擊或雙擊鼠標(biāo)時通知父窗口．
|
|
LBS_OWNERDRAWFIXED
|
指定自繪式列表框，即由父窗口負(fù)責(zé)繪制列表框的內(nèi)容，并且列表項(xiàng)有相同的高度．
|
|
LBS_OWNERDRAWVARIABLE
|
指定自繪式列表框，并且列表項(xiàng)有不同的高度．
|
|
LBS_SORT
|
使插入列表框中的項(xiàng)按升序排列．
|
|
LBS_STANDARD
|
相當(dāng)于指定了 WS_BORDER|WS_VSCROLL|LBS_SORT |LBS_NOTIFY．
|
|
LBS_USETABSTOPS
|
使列表框在顯示列表項(xiàng)時識別并擴(kuò)展制表符 (‘\t’)，缺省的制表寬度是32個對話框單位．
|
|
LBS_WANTKEYBOARDINPUT
|
允許列表框的父窗口接收 WM_VKEYTOITEM和WM_CHARTOITEM消息，以響應(yīng)鍵盤輸入．
|
|
LBS_DISABLENOSCROLL
|
使列表框在不需要滾動時顯示一個禁止的垂直滾動條．
|
除了上表中的風(fēng)格外，一般還要為列表框控件指定WS_CHILD、WS_VISIBLE、WS_TABSTOP、WS_BORDER和WS_VSCROLL風(fēng)格．要創(chuàng)建一個普通的單選擇列表框，應(yīng)指定的風(fēng)格為WS_CHILD|WS_VISIBLE|WS_TABSTOP|LBS_STANDARD．要創(chuàng)建一個多重選擇列表框，應(yīng)該在單選擇列表框風(fēng)格的基礎(chǔ)上再加上 LBS_MULTIPLESEL或LBS_ EXTENDEDSEL．如果不希望列表框排序，就不能使用LBS_STANDARD風(fēng)格．
對于用對話框模板編輯器創(chuàng)建的列表框控件，可以在控件的屬性對話框中指定表6.10中列出的控件風(fēng)格。例如，在屬性對話框中選擇Sort項(xiàng)，相當(dāng)與指定了LBS_SORT風(fēng)格。
CListBox類的成員函數(shù)有數(shù)十個之多．我們可以把一些常用的函數(shù)分為三類，在下面列出．需要說明的是，可以用索引來指定列表項(xiàng)，索引是從零開始的．
首先，CListBox成員函數(shù)提供了下列函數(shù)用于插入和刪除列表項(xiàng)．
int AddString( LPCTSTR lpszItem );
該函數(shù)用來往列表框中加入字符串，其中參數(shù)lpszItem指定了要添加的字符串．函數(shù)的返回值是加入的字符串在列表框中的位置，如果發(fā)生錯誤，會返回LB_ERR或LB_ERRSPACE（內(nèi)存不夠）．如果列表框未設(shè)置LBS_SORT風(fēng)格，那么字符串將被添加到列表的末尾，如果設(shè)置了LBS_SORT風(fēng)格，字符串會按排序規(guī)律插入到列表中．
int InsertString( int nIndex, LPCTSTR lpszItem );
該函數(shù)用來在列表框中的指定位置插入字符串．參數(shù)nIndex給出了插入位置（索引），如果值為-1，則字符串將被添加到列表的末尾．參數(shù)lpszItem指定了要插入的字符串．函數(shù)返回實(shí)際的插入位置，若發(fā)生錯誤，會返回LB_ERR或LB_ERRSPACE．與AddString函數(shù)不同，InsertString函數(shù)不會導(dǎo)致LBS_SORT風(fēng)格的列表框重新排序．不要在具有LBS_SORT風(fēng)格的列表框中使用InsertString函數(shù)，以免破壞列表項(xiàng)的次序．
int DeleteString( UINT nIndex );
該函數(shù)用于刪除指定的列表項(xiàng)，其中參數(shù)nIndex指定了要刪除項(xiàng)的索引．函數(shù)的返回值為剩下的表項(xiàng)數(shù)目，如果nIndex超過了實(shí)際的表項(xiàng)總數(shù)，則返回LB_ERR．
void ResetContent( );
該函數(shù)用于清除所有列表項(xiàng)．
int Dir( UINT attr, LPCTSTR lpszWildCard );
該函數(shù)用來向列表項(xiàng)中加入所有與指定通配符相匹配的文件名或驅(qū)動器名．參數(shù)attr為文件類型的組合，如表6.11所示．參數(shù)lpszWildCard指定了通配符（如*.cpp，*.*等）．
表6.11 Dir函數(shù)attr參數(shù)的含義
|
值
|
含義
|
|
0x0000
|
普通文件（可讀寫的文件）．
|
|
0x0001
|
只讀文件．
|
|
0x0002
|
隱藏文件．
|
|
0x0004
|
系統(tǒng)文件．
|
|
0x0010
|
目錄．
|
|
0x0020
|
文件的歸檔位已被設(shè)置．
|
|
0x4000
|
包括了所有與通配符相匹配的驅(qū)動器．
|
|
0x8000
|
排除標(biāo)志．若指定該標(biāo)志，則只列出指定類型的文件名，否則，先要列出普通文件，然后再列出指定的文件．
|
下列的CListBox成員函數(shù)用于搜索、查詢和設(shè)置列表框．
int GetCount( ) const;
該函數(shù)返回列表項(xiàng)的總數(shù)，若出錯則返回LB_ERR．
int FindString( int nStartAfter, LPCTSTR lpszItem ) const;
該函數(shù)用于對列表項(xiàng)進(jìn)行與大小寫無關(guān)的搜索．參數(shù)nStartAfter指定了開始搜索的位置, 合理指定nStartAfter可以加快搜索速度，若nStartAfter為-1，則從頭開始搜索整個列表．參數(shù)lpszItem指定了要搜索的字符串．函數(shù)返回與lpszItem指定的字符串相匹配的列表項(xiàng)的索引，若沒有找到匹配項(xiàng)或發(fā)生了錯誤，函數(shù)會返回LB_ERR．FindString函數(shù)先從nStartAfter指定的位置開始搜索，若沒有找到匹配項(xiàng)，則會從頭開始搜索列表．只有找到匹配項(xiàng)，或?qū)φ麄€列表搜索完一遍后，搜索過程才會停止，所以不必?fù)?dān)心會漏掉要搜索的列表項(xiàng)．
int GetText( int nIndex, LPTSTR lpszBuffer ) const;
void GetText( int nIndex, CString& rString ) const;
用于獲取指定列表項(xiàng)的字符串．參數(shù)nIndex指定了列表項(xiàng)的索引．參數(shù)lpszBuffer指向一個接收字符串的緩沖區(qū)．引用參數(shù)rString則指定了接收字符串的CString對象．第一個版本的函數(shù)會返回獲得的字符串的長度，若出錯，則返回LB_ERR．
int GetTextLen( int nIndex ) const;
該函數(shù)返回指定列表項(xiàng)的字符串的字節(jié)長度．參數(shù)nIndex指定了列表項(xiàng)的索引．若出錯則返回LB_ERR．
DWORD GetItemData( int nIndex ) const;
每個列表項(xiàng)都有一個32位的附加數(shù)據(jù)．該函數(shù)返回指定列表項(xiàng)的附加數(shù)據(jù)，參數(shù)nIndex指定了列表項(xiàng)的索引．若出錯則函數(shù)返回LB_ERR．
int SetItemData( int nIndex, DWORD dwItemData );
該函數(shù)用來指定某一列表項(xiàng)的32位附加數(shù)據(jù)．參數(shù)nIndex指定了列表項(xiàng)的索引．dwItemData是要設(shè)置的附加數(shù)據(jù)值．
| 提示:列表項(xiàng)的32位附加數(shù)據(jù)可用來存儲與列表項(xiàng)相關(guān)的數(shù)據(jù)，也可以放置指向相關(guān)數(shù)據(jù)的指針．這樣，當(dāng)用戶選擇了一個列表項(xiàng)時，程序可以從附加數(shù)據(jù)中快速方便地獲得與列表項(xiàng)相關(guān)的數(shù)據(jù)． |
int GetTopIndex( ) const;
該函數(shù)返回列表框中第一個可見項(xiàng)的索引，若出錯則返回LB_ERR．
int SetTopIndex( int nIndex );
用來將指定的列表項(xiàng)設(shè)置為列表框的第一個可見項(xiàng)，該函數(shù)會將列表框滾動到合適的位置．參數(shù)nIndex指定了列表項(xiàng)的索引．若操作成功，函數(shù)返回0值，否則返回LB_ERR．
| 提示：由于列表項(xiàng)的內(nèi)容一般是不變的，故CListBox未提供更新列表項(xiàng)字符串的函數(shù)．如果要改變某列表項(xiàng)的內(nèi)容，可以先調(diào)用DeleteString刪除該項(xiàng)，然后再用InsertString或AddString將更新后的內(nèi)容插入到原來的位置． |
下列CListBox的成員函數(shù)與列表項(xiàng)的選擇有關(guān)．
int GetSel( int nIndex ) const;
該函數(shù)返回指定列表項(xiàng)的狀態(tài)．參數(shù)nIndex指定了列表項(xiàng)的索引．如果查詢的列表項(xiàng)被選擇了，函數(shù)返回一個正值，否則返回0，若出錯則返回LB_ERR．
int GetCurSel( ) const;
該函數(shù)僅適用于單選擇列表框，用來返回當(dāng)前被選擇項(xiàng)的索引，如果沒有列表項(xiàng)被選擇或有錯誤發(fā)生，則函數(shù)返回LB_ERR．
int SetCurSel( int nSelect );
該函數(shù)僅適用于單選擇列表框，用來選擇指定的列表項(xiàng)．該函數(shù)會滾動列表框以使選擇項(xiàng)可見．參數(shù)nIndex指定了列表項(xiàng)的索引，若為-1，那么將清除列表框中的選擇．若出錯函數(shù)返回LB_ERR．
int SelectString( int nStartAfter, LPCTSTR lpszItem );
該函數(shù)僅適用于單選擇列表框，用來選擇與指定字符串相匹配的列表項(xiàng)．該函數(shù)會滾動列表框以使選擇項(xiàng)可見．參數(shù)的意義及搜索的方法與函數(shù)FindString類似．如果找到了匹配的項(xiàng)，函數(shù)返回該項(xiàng)的索引，如果沒有匹配的項(xiàng)，函數(shù)返回LB_ERR并且當(dāng)前的選擇不被改變．
int GetSelCount( ) const;
該函數(shù)僅用于多重選擇列表框，它返回選擇項(xiàng)的數(shù)目，若出錯函數(shù)返回LB_ERR．
int SetSel( int nIndex, BOOL bSelect = TRUE );
該函數(shù)僅適用于多重選擇列表框，它使指定的列表項(xiàng)選中或落選．參數(shù)nIndex指定了列表項(xiàng)的索引，若為-1，則相當(dāng)于指定了所有的項(xiàng)．參數(shù)bSelect為TRUE時選中列表項(xiàng)，否則使之落選．若出錯則返回LB_ERR．
int GetSelItems( int nMaxItems, LPINT rgIndex ) const;
該函數(shù)僅用于多重選擇列表框，用來獲得選中的項(xiàng)的數(shù)目及位置．參數(shù)nMaxItems說明了參數(shù)rgIndex指向的數(shù)組的大小．參數(shù)rgIndex指向一個緩沖區(qū)，該數(shù)組是一個整型數(shù)組，用來存放選中的列表項(xiàng)的索引．函數(shù)返回放在緩沖區(qū)中的選擇項(xiàng)的實(shí)際數(shù)目，若出錯函數(shù)返回LB_ERR．
int SelItemRange( BOOL bSelect, int nFirstItem, int nLastItem );
該函數(shù)僅用于多重選擇列表框，用來使指定范圍內(nèi)的列表項(xiàng)選中或落選．參數(shù)nFirstItem和nLastItem指定了列表項(xiàng)索引的范圍．如果參數(shù)bSelect為TRUE，那么就選擇這些列表項(xiàng)，否則就使它們落選．若出錯函數(shù)返回LB_ERR．
在6.1.8小節(jié)的例子中，讀者將會看到對列表框的測試．
6.1.7 組合框控件
組合框把一個編輯框和一個單選擇列表框結(jié)合在了一起．用戶既可以在編輯框中輸入，也可以從列表框中選擇一個列表項(xiàng)來完成輸入．如上一章所提到的，組合框分為簡易式(Simple)、下拉式(Dropdown)和下拉列表式(Drop List)三種．簡易式組合框包含一個編輯框和一個總是顯示的列表框。下拉式組合框同簡易式組合框類似，二者的區(qū)別在于僅當(dāng)單擊下滾箭頭后列表框才會彈出。下拉列表式組合框也有一個下拉的列表框，但它的編輯框是只讀的，不能輸入字符。
Windows
中比較常用的是下拉式和下拉列表式組合框，在Developer Studio中就大量使用了這兩種組合框．二者都具有占地小的特點(diǎn)，這在界面日益復(fù)雜的今天是十分重要的．下拉列表式組合框的功能與列表框類似．下拉式組合框的典型應(yīng)用是作為記事列表框使用，既把用戶在編輯框中敲入的東西存儲到列表框組件中，這樣當(dāng)用戶要重復(fù)同樣的輸入時，可以從列表框組件中選取而不必在編輯框組件中從新輸入．在Developer Studio中的Find對話框中就可以找到一個典型的下拉式組合框．
要設(shè)計(jì)一個記事列表框，應(yīng)采取下列原則：
在創(chuàng)建組合框時指定
CBS_DROPDOWNLIST風(fēng)格．
要限制列表項(xiàng)的數(shù)目，以防止內(nèi)存不夠．
如果在編輯框中輸入的字符串不能與列表框組件中的列表項(xiàng)匹配，那么應(yīng)該把該字符串插入到列表框中的
0位置處．最老的項(xiàng)處于列表的末尾．如果列表項(xiàng)的數(shù)目超出了限制，則應(yīng)把最老的項(xiàng)刪除．
如果在編輯框中輸入的字符串可以與列表框組件中的某一項(xiàng)完全匹配，則應(yīng)該先把該項(xiàng)從列表的當(dāng)前位置刪除，然后在將其插入道列表的
0位置處．
組合框控件會向父窗口發(fā)送表6.12所示的通知消息．
表
6.12 組合框控件的通知消息
|
消息
|
含義
|
|
CBN_CLOSEUP
|
組合框的列表框組件被關(guān)閉．簡易式組合框不會發(fā)出該消息．
|
|
CBN_DBLCLK
|
用戶在某列表項(xiàng)上雙擊鼠標(biāo)．只有簡易式組合框才會發(fā)出該消息．
|
|
CBN_DROPDOWN
|
組合框的列表框組件下拉．簡易式組合框不會發(fā)出該消息．
|
|
CBN_EDITCHANGE
|
編輯框的內(nèi)容被用戶改變了。與 CBN_EDITUPDATE不同，該消息是在編輯框顯示的正文被刷新后才發(fā)出的。下拉列表式組合框不會發(fā)出該消息．
|
|
CBN_EDITUPDATE
|
在編輯框準(zhǔn)備顯示改變了的正文時發(fā)送該消息。下拉列表式組合框不會發(fā)出該消息．
|
|
CBN_ERRSPACE
|
組合框無法申請足夠的內(nèi)存來容納列表項(xiàng)．
|
|
CBN_SELENDCANCEL
|
表明用戶的選擇應(yīng)該取消．當(dāng)用戶在列表框中選擇了一項(xiàng)，然后又在組合框控件外單擊鼠標(biāo)時就會導(dǎo)致該消息的發(fā)送．
|
|
CBN_SELENDOK
|
用戶選擇了一項(xiàng)，然后按了回車鍵或單擊了下滾箭頭．該消息表明用戶確認(rèn)了自己所作的選擇．
|
|
CBN_KILLFOCUS
|
組合框失去了輸入焦點(diǎn)．
|
|
CBN_SELCHANGE
|
用戶通過點(diǎn)擊或移動箭頭鍵改變了列表的選擇．
|
|
CBN_SETFOCUS
|
組合框獲得了輸入焦點(diǎn)．
|
MFC的CComboBox類封裝了組合框．需要指出的是，雖然組合框是編輯框和列表框的選擇，但是CComboBox類并不是CEdit類和CListBox類的派生類，而是CWnd類的派生類．
CComboBox的成員函數(shù)Create負(fù)責(zé)創(chuàng)建組合框，該函數(shù)的說明如下：
BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );
參數(shù)dwStyle指定了組合框控件的風(fēng)格，如表6.10所示，dwStyle可以是這些風(fēng)格的組合．rect說明的是列表框組件下拉后組合框的位置和尺寸．pParentWnd指向父窗口，該參數(shù)不能為NULL。nID則說明了控件的ID。如果創(chuàng)建成功，該函數(shù)返回TRUE，否則返回FALSE．
| 提示：在用Create函數(shù)創(chuàng)建組合框時，參數(shù)rect說明的是包括列表框組件在內(nèi)的組合框的位置和尺寸，而不是列表框組件隱藏時的編輯框組件尺寸．要設(shè)置編輯框組件的高度，可以調(diào)用成員函數(shù)SetItemHeight(-1,cyItemHeight)，其中參數(shù)cyItemHeight指定了編輯框的高度（以像素為單位）． |
表6.13 組合框的風(fēng)格
|
控件風(fēng)格
|
含義
|
|
CBS_AUTOHSCROLL
|
使編輯框組件具有水平滾動的風(fēng)格．
|
|
CBS_DROPDOWN
|
指定一個下拉式組合框．
|
|
CBS_DROPDOWNLIST
|
指定一個下拉列表式組合框．
|
|
CBS_HASSTRINGS
|
指定一個含有字符串的自繪式組合框．
|
|
CBS_OEMCONVERT
|
使編輯框組件中的正文可以在 ANSI字符集和OEM字符集之間相互轉(zhuǎn)換。這在編輯框中包含文件名時是很有用的。
|
|
CBS_OWNERDRAWFIXED
|
指定自繪式組合框，即由父窗口負(fù)責(zé)繪制列表框的內(nèi)容，并且列表項(xiàng)有相同的高度．
|
|
CBS_OWNERDRAWVARIABLE
|
指定自繪式組合框，并且列表項(xiàng)有不同的高度．
|
|
CBS_SIIMPLE
|
指定一個簡易式組合框．
|
|
CBS_SORT
|
自動對列表框組件中的項(xiàng)進(jìn)行排序．
|
|
CBS_DISABLENOSCROLL
|
使列表框在不需要滾動時顯示一個禁止的垂直滾動條．
|
|
CBS_NOINTEGRALHEIGHT
|
組合框的尺寸由應(yīng)用程序而不是 Windows指定．通常，由Windows指定尺寸會使列表項(xiàng)的某些部分隱藏起來．
|
CBS_SIMPLE
、CBS_DROPDOWN和CBS_DROPDOWNLIST分別用來將組合框指定為簡易式、下拉式和下拉列表式．一般還要為組合框指定WS_CHILD、WS_VISIBLE、WS_TABSTOP、WS_VSCROLL和CBS_AUTOHSCROLL風(fēng)格．如果要求自動排序，還應(yīng)指定CBS_SORT風(fēng)格．
對于用對話框模板編輯器創(chuàng)建的組合框控件，可以在控件的屬性對話框中指定上表中列出的控件風(fēng)格。例如，在屬性對話框中選擇Dropdown，相當(dāng)于指定了CBS_DROPDOWN．
CComboBox
類的成員函數(shù)較多．其中常用的函數(shù)可粗分為兩類，分別針對編輯框組件和列表框組件．可以想象，這些函數(shù)與CEdit類和CListBox類的成員函數(shù)肯定有很多類似之處，但它們也會有一些不同的特點(diǎn)．如果讀者能從＂組合框是由編輯框和列表框組成＂這一概念出發(fā)，就能夠很快的掌握CComboBox的主要成員函數(shù)．
事實(shí)上，絕大部分CComboBox的成員函數(shù)都可以看成是CEdit或CListBox成員函數(shù)的翻版．函數(shù)的功能，函數(shù)名，甚至函數(shù)的參數(shù)都是類似的．為了方便學(xué)習(xí)，在下面列出CComboBox類的成員函數(shù)時，采用了與對應(yīng)的CEdit或CListBox成員函數(shù)相比較的做法．在成員函數(shù)的列表中，分別列出了成員函數(shù)名，對應(yīng)的CEdit或CListBox成員函數(shù)，以及二者之間的不同之處．不同之處是指函數(shù)的功能、參數(shù)以及返回值有什么差別．
<