大龙的博客

mfc 传统控件

6.1 传统控件

在上一课的表5.1已经列出了Windows的传统控件及其对应的控件类。在这些控件中，读者应该重点掌握命令按钮、选择框、单选按钮、编辑框、列表框和组合框。

.1.1 传统控件的控件通知消息

控件通过向父窗口发送控件通知消息来表明发生了某种事件．例如，当用户在按钮上单击鼠标时，按钮控件会向父窗口发送BN_CLICKED消息．传统控件的通知消息实际上是通过WM_COMMAND消息发给父窗口的（滚动条除外），在该消息的wParam中含有通知消息码（如BN_CLICKED）和控件的ID，在lParam中则包含了控件的句柄．

利用ClassWizard可以很容易地为控件通知消息加入消息映射和消息处理函数，这在上一章中已经演示过了．传统控件的消息映射宏是ON_XXXX，其中XXXX表示通知消息码，如BN_CLICKED．ON_XXXX消息映射如下所示，该宏有两个参数，一个是控件的ID，一个是消息处理函数名．

消息处理函数的声明应该有如下形式：

例如，某按钮的BN_CLICKED消息的消息映射及其处理函数的声明如下所示

有时，为了处理方便，需要把多个ID连续的控件发出的相同消息映射到同一个处理函数上．这就要用到ON_CONTROL_RANGE宏．ON_CONTROL_RANGE消息映射宏的第一个参数是控件消息码，第二和第三个参数分别指明了一组连续的控件ID中的头一个和最后一个ID，最后一个参数是消息处理函数名。例如，要处理一组单选按钮发出的BN_CLICKED消息，相应的消息映射如下所示：

ON_CONTROL_RANGE(BN_CLICKED, IDC_FIRST, IDC_LAST, OnRadioClicked)

函数OnRadioClicked的声明如下，该函数比上面的OnAdd多了一个参数nID以说明发送通知消息的控件ID．

ClassWizard不支持ON_CONTROL_RANGE宏，所以需要手工建立消息映射和消息处理函数．

6.1.2 静态控件

静态控件包括静态正文(Static Text)和图片控件(Picture)。静态正文控件用来显示正文。图片控件可以显示位图、图标、方框和图元文件，在图片控件中显示图片的好处是不必操心图片的重绘问题。静态控件不能接收用户的输入。在上一章中，读者已经用过静态正文和组框控件。图片控件的例子可以在AppWizard创建的IDD_ABOUTBOX对话框模板中找到，在该模板中有一个图片控件用来显示图标。

静态控件的主要起说明和装饰作用。MFC的CStatic类封装了静态控件。CStatic类的成员函数Create负责创建静态控件，该函数的声明为

BOOL Create( LPCTSTR lpszText, DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID = 0xffff );

参数lpszText指定了控件显示的正文。dwStyle指定了静态控件的风格，表6.1显示了静态控件的各种风格，dwStyle可将这些风格组合起来。rect是一个对RECT或CRect结构的引用，用来说明控件的位置和尺寸。pParentWnd指向父窗口，该参数不能为NULL。nID则说明了控件的ID。如果创建成功，该函数返回TRUE，否则返回FALSE．

表6.1 静态控件的风格

除了上表中的风格外，一般还要为控件指定WS_CHILD和WS_VISIBLE窗口风格。一个典型的静态正文控件的风格为WS_CHILD|WS_VISIBLE|SS_LEFT。

对于用对话框模板编辑器创建的静态控件，可以在控件的属性对话框中指定表6.1中列出的控件风格。例如，可以在静态正文控件的属性对话框中选择Simple，这相当于指定了SS_SIMPLE风格。

Cstatic类主要的成员函数在表6.2中列出。可以利用CWnd类的成员函数GetWindowText，SetWindowText和GetWindowTextLength等函数来查询和设置静态控件中显示的正文．

表6.2 CStatic类的主要成员函数

静态控件较简单，故这里就不举例说明了。

6.1.3 按钮控件

按钮是指可以响应鼠标点击的小矩形子窗口。按钮控件包括命令按钮(Pushbutton)、检查框(Check Box)、单选按钮(Radio Button)、组框(Group Box)和自绘式按钮(Owner-draw Button)。命令按钮的作用是对用户的鼠标单击作出反应并触发相应的事件，在按钮中既可以显示正文，也可以显示位图。选择框控件可作为一种选择标记，可以有选中、不选中和不确定三种状态。单选按钮控件一般都是成组出现的，具有互斥的性质，即同组单选按钮中只能有一个是被选中的。组框用来将相关的一些控件聚成一组．自绘式按钮是指由程序而不是系统负责重绘的按钮。

按钮主要是指命令按钮、选择框和单选按钮。后二者实际上是一种特殊的按钮，它们有选择和未选择状态。当一个选择框处于选择状态时，在小方框内会出现一个“√”，当单选按钮处于选择状态时，会在圆圈中显示一个黑色实心圆。此外，检查框还有一种不确定状态，这时检查框呈灰色显示，不能接受用户的输入，以表明控件是无效的或无意义的。

按钮控件会向父窗口发出如表6.3所示的控件通知消息。

表6.3 按钮控件的通知消息

FC的CButton类封装了按钮控件。CButton类的成员函数Create负责创建按钮控件，该函数的声明为

BOOL Create( LPCTSTR lpszCaption, DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );

参数lpszCaption指定了按钮显示的正文。dwStyle指定了按钮的风格，如表6.4所示，dwStyle可以是这些风格的组合。rect说明了按钮的位置和尺寸。pParentWnd指向父窗口，该参数不能为NULL。nID是按钮的ID。如果创建成功，该函数返回TRUE，否则返回FALSE．

表6.4 按钮的风格

除了上表中的风格外，一般还要为控件指定WS_CHILD、WS_VISIBLE和WS_TABSTOP窗口风格，WS_TABSTOP使控件具有Tabstop属性。创建一个普通按钮应指定的风格为WS_CHILD|WS_VISIBLE|WS_TABSTOP。创建一个普通检查框应指定风格WS_CHILD|WS_VISIBLE|WS_TABSTOP| BS_AUTOCHECKBOX。创建组中第一个单选按钮应指定风格WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_GROUP| BS_AUTORADIOBUTTON，组中其它单选按钮应指定风格则不应该包括WS_TABSTOP和WS_GROUP。

对于用对话框模板编辑器创建的按钮控件，可以在控件的属性对话框中指定表6.4中列出的控件风格。例如，在命令按钮的属性对话框中选择Default button，相当于指定了BS_DEFPUSHBUTTON。

CButton类的主要的成员函数有：

UINT GetState( ) const;
该函数返回按钮控件的各种状态。可以用下列屏蔽值与函数的返回值相与，以获得各种信息。

0x0003。用来获取检查框或单选按钮的状态。0表示未选中，1表示被选中，2表示不确定状态（仅用于检查框）。

0x0004。用来判断按钮是否是高亮度显示的。非零值意味着按钮是高亮度显示的。当用户点击了按钮并按主鼠标左键时，按钮会呈高亮度显示。

0x0008。非零值表示按钮拥有输入焦点。

void SetState( BOOL bHighlight );
当参数bHeightlight值为TRUE时，该函数将按钮设置为高亮度状态，否则，去除按钮的高亮度状态。

int GetCheck( ) const;
返回检查框或单选按钮的选择状态。返回值0表示按钮未被选择，1表示按钮被选择，2表示按钮处于不确定状态（仅用于检查框）。

void SetCheck( int nCheck );
设置检查框或单选按钮的选择状态。参数nCheck值的含义与GetCheck返回值相同。

UINT GetButtonStyle( ) const;
获得按钮控件的BS_XXXX风格。

void SetButtonStyle( UINT nStyle, BOOL bRedraw = TRUE );
设置按钮的风格。参数nStyle指定了按钮的风格。bRedraw为TRUE则重绘按钮，否则就不重绘。

HBITMAP SetBitmap( HBITMAP hBitmap );
设置按钮显示的位图。参数hBitmap指定了位图的句柄。该函数还会返回按钮原来的位图。

HBITMAP GetBitmap( ) const;
返回以前用SetBitmap设置的按钮位图。

HICON SetIcon( HICON hIcon );
设置按钮显示的图标。参数hIcon指定了图标的句柄。该函数还会返回按钮原来的图标。

HICON GetIcon( ) const;
返回以前用SetIcon设置的按钮图标。

HCURSOR SetCursor( HCURSOR hCursor );
设置按钮显示的光标图。参数hCursor指定了光标的句柄。该函数还会返回按钮原来的光标。

HCURSOR GetCursor( );
返回以前用GetCursor设置的光标。

另外，可以使用下列的一些与按钮控件有关的CWnd成员函数来设置或查询按钮的状态。用这些函数的好处在于不必构建按钮控件对象，只要知道按钮的ID，就可以直接设置或查询按钮。

void CheckDlgButton( int nIDButton, UINT nCheck );
用来设置按钮的选择状态。参数nIDButton指定了按钮的ID。nCheck的值0表示按钮未被选择，1表示按钮被选择，2表示按钮处于不确定状态。

void CheckRadioButton( int nIDFirstButton, int nIDLastButton, int nIDCheckButton );
用来选择组中的一个单选按钮。参数nIDFirstButton指定了组中第一个按钮的ID，nIDLastButton指定了组中最后一个按钮的ID，nIDCheckButton指定了要选择的按钮的ID。

int GetCheckedRadioButton( int nIDFirstButton, int nIDLastButton );
该函数用来获得一组单选按钮中被选中按钮的ID。参数nIDFirstButton说明了组中第一个按钮的ID，nIDLastButton说明了组中最后一个按钮的ID。

UINT IsDlgButtonChecked( int nIDButton ) const;
返回检查框或单选按钮的选择状态。返回值0表示按钮未被选择，1表示按钮被选择，2表示按钮处于不确定状态（仅用于检查框）。

可以调用CWnd成员函数GetWindowText，GetWindowTextLength和SetWindowText来查询或设置按钮中显示的正文．

MFC还提供了CButton的派生类CBitmapButton。利用该类可以创建一个拥有四幅位图的命令按钮，按钮在不同状态时会显示不同的位图，这样可以使界面显得生动活泼。如果读者对CBitmapButton感兴趣，可以参看VC5.0随盘提供的MFC例子CTRLTEST。

在上一章的Register例子中已演示了各种按钮控件的使用，故这里就不再举例了。

6.1.4 编辑框控件

编辑框(Edit Box)控件实际上是一个简易的正文编辑器，用户可以在编辑框中输入并编辑正文。编辑框既可以是单行的，也可以是多行的，多行编辑框是从零开始编行号的．在一个多行编辑框中，除了最后一行外，每一行的结尾处都有一对回车换行符（用＂\r\n＂表示）．这对回车换行符是正文换行的标志，在屏幕上是不可见的．

编辑框控件会向父窗口发出如表6.5所示的控件通知消息。

表6.5

MFC的CEdit类封装了编辑框控件。CEdit类的成员函数Create负责创建按钮控件，该函数的声明为

BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );

参数dwStyle指定了编辑框控件风格，如表6.6所示，dwStyle可以是这些风格的组合。rect指定了编辑框的位置和尺寸。pParentWnd指定了父窗口，不能为NULL。编辑框的ID由nID指定。如果创建成功，该函数返回TRUE，否则返回FALSE．

表6.6 编辑框控件的风格

除了上表中的风格外，一般还要为控件指定WS_CHILD、WS_VISIBLE、WS_TABSTOP和WS_BORDER窗口风格，WS_BORDER使控件带边框。创建一个普通的单行编辑框应指定风格为WS_CHILD|WS_VISIBLE|WS_TABSTOP |WS_BORDER|ES_LEFT|ES_AUTOHSCROLL，这将创建一个带边框、左对齐正文、可水平滚动的单行编辑器。要创建一个普通多行编辑框，还要附加ES_MULTILINE|ES_WANTRETURN|ES_AUTOVSCROLL |WS_HSCROLL| WS_VSCROLL风格，这将创建一个可水平和垂直滚动的，带有水平和垂直滚动条的多行编辑器。

对于用对话框模板编辑器创建的编辑框控件，可以在控件的属性对话框中指定表6.6中列出的控件风格。例如，在属性对话框中选择Multi-line项，相当与指定了ES_MULTILINE风格。

编辑框支持剪贴板操作。CEdit类提供了一些与剪贴板有关的成员函数，如表6.7所示。

表6.7 与剪切板有关的CEdit成员函数

可以用下列CEdit或CWnd类的成员函数来查询编辑框。在学习下面的函数时，读者会经常遇到术语字符索引．字符的字符索引是指从编辑框的开头字符开始的字符编号，它是从零开始编号的．也就是说，字符索引实际上是指当把整个编辑正文看作一个字符串数组时，该字符所在的数组元素的下标．

int GetWindowText( LPTSTR lpszStringBuf, int nMaxCount ) const;
void GetWindowText( CString& rString ) const;
这两个函数均是CWnd类的成员函数，可用来获得窗口的标题或控件中的正文。第一个版本的函数用lpszStringBuf参数指向的字符串数组作为拷贝正文的缓冲区，参数nMaxCount可以拷贝到缓冲区中的最大字符数，该函数返回以字节为单位的实际拷贝字符数（不包括结尾的空字节）。第二个版本的函数用一个CString对象作为缓冲区。

int GetWindowTextLength( ) const;
CWnd的成员函数，可用来获得窗口的标题或控件中的正文的长度。

DWORD GetSel( ) const;
void GetSel( int& nStartChar, int& nEndChar ) const;
两个函数都是CEdit的成员函数，用来获得所选正文的位置。GetSel的第一个版本返回一个DWORD值，其中低位字说明了被选择的正文开始处的字符索引，高位字说明了选择的正文结束处的后面一个字符的字符索引，如果没有正文被选择，那么返回的低位和高位字节都是当前插入符所在字符的字符索引。GetSel的第二个版本的两个参数是两个引用，其含义与第一个版本函数返回值的低位和高位字相同。

int LineFromChar( int nIndex = –1 ) const;
CEdit的成员函数，仅用于多行编辑框，用来返回指定字符索引所在行的行索引（从零开始编号）。参数nIndex指定了一个字符索引，如果nIndex是-1，那么函数将返回选择正文的第一个字符所在行的行号，若没有正文被选择，则该函数会返回当前的插入符所在行的行号。

int LineIndex( int nLine = –1 ) const;
CEdit的成员函数，仅用于多行编辑框，用来获得指定行的开头字符的字符索引，如果指定行超过了编辑框中的最大行数，该函数将返回-1。参数nLine是指定了从零开始的行索引，如果它的值为-1，则函数返回当前的插入符所在行的字符索引。

int GetLineCount( ) const;
CEdit的成员函数，仅用于多行编辑框，用来获得正文的行数。如果编辑框是空的，那么该函数的返回值是1。

int LineLength( int nLine = –1 ) const;
CEdit的成员函数，用于获取指定字符索引所在行的字节长度（行尾的回车和换行符不计算在内）。参数nLine说明了字符索引．如果nLine的值为-1，则函数返回当前行的长度（假如没有正文被选择），或选择正文占据的行的字符总数减去选择正文的字符数（假如有正文被选择）。若用于单行编辑框，则函数返回整个正文的长度。

int GetLine( int nIndex, LPTSTR lpszBuffer ) const;
int GetLine( int nIndex, LPTSTR lpszBuffer, int nMaxLength ) const;
CEdit的成员函数，仅用于多行编辑框，用来获得指定行的正文（不包括行尾的回车和换行符）。参数nIndex是行号，lpszBuffer指向存放正文的缓冲区，nMaxLength规定了拷贝的最大字节数，若。函数返回实际拷贝的字节数，若指定的行号大于编辑框的实际行数，则函数返回0。需要注意的是，GetLine函数不会在缓冲区中字符串的末尾加字符串结束符(NULL)．

下列CWnd或CEdit类的成员函数可用来修改编辑框控件。

void SetWindowText( LPCTSTR lpszString );
CWnd的成员函数，可用来设置窗口的标题或控件中的正文。参数lpszString可以是一个CString对象，或是一个指向字符串的指针。

void SetSel( DWORD dwSelection, BOOL bNoScroll = FALSE );
void SetSel( int nStartChar, int nEndChar, BOOL bNoScroll = FALSE );
CEdit的成员函数，用来选择编辑框中的正文。参数dwSelection的低位字说明了选择开始处的字符索引，高位字说明了选择结束处的字符索引。如果低位字为0且高位字节为-1，那么就选择所有的正文，如果低位字节为-1，则取消所有的选择．参数bNoScroll的值如果是FALSE，则滚动插入符并使之可见，否则就不滚动．参数nStartChar和nEndChar的含义与参数dwSelection的低位字和高位字相同．

void ReplaceSel( LPCTSTR lpszNewText, BOOL bCanUndo = FALSE );
CEdit的成员函数，用来将所选正文替换成指定的正文．参数lpszNewText指向用来替换的字符串．参数bCanUndo的值为TRUE说明替换是否可以被撤消的．

在调用上述函数时，如果涉及的是一个多行编辑框，那么除了LineLength和GetLine函数外，都要把回车和换行符考虑在内．例如，假设在编辑框中有如下几行正文：

那么字母＂e＂的字符索引是6而不是4，因为＂abcd＂后面还有一对回车换行符．调用LineLength(7)会返回第二行的长度3．调用LineIndex(2)会得到11．调用LineFromChar(8)会返回1．如果没有选择任何正文，并且插入符在字母＂e＂上，那么调用GetSel返回值的低位和高位字都是6．

通过分析上述函数，我们可以总结出一些查询和设置编辑框的方法．

调用CWnd的成员函数GetWindowText和SetWindowText可以查询和设置编辑框的整个正文，在上一章的Register程序中，我们就使用过这两个函数．

如果想对多行编辑框逐行查询，那么应该先调用GetLineCount获得总行数，然后再调用GetLine来获取每一行的正文．下面一段代码演示了如何对多行编辑框进行逐行查询．

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; //加字符串结束符

. . . . . .

}

可以利用LineIndex和LineFromChar来在字符索引和字符的行列坐标之间相互转换．下列代码演示了在已知字符索引的情况下，如何获得对应的行列坐标：
int row,column;
row=MyEdit.LineFromChar(charIndex);
column=charIndex-MyEdit.LineIndex(row);
下列代码演示了在已知字符的行列坐标的情况下，如何获得对应的字符索引：
int charIndex;
charIndex=MyEdit.LineIndex(row)+column;
不难看出字符索引与对应的行列坐标的关系是：字符索引=LineIndex(行坐标)+列坐标．

对于选择正文的查询和设置，应该利用函数GetSel、SetSel和ReplaceSel．

可以利用GetSel和SetSel来查询和设置插入符的位置．SetSel可以使编辑框滚动到插入符的新位置．
要获取插入符的行列坐标，可用下面的代码实现：
MyEdit.SetSel(-1,0); //取消正文的选择
int start,end,row,column;
MyEdit.GetSel(start,end); //start或end的值就是插入符的字符索引
row=MyEdit.LineFromChar(start); //获取插入符的行坐标
column=start-MyEdit.LineIndex(row); //获取插入符的列坐标
下面的代码演示了如何把插入符移到指定的行和列：
MyEdit.SetSel(-1,0); //取消正文的选择
int charIndex=MyEdit.LineIndex(row)+column;
MyEdit.SetSel(charIndex,charIndex);

可以利用ReplaceSel函数在 插入符处插入正文，典型的代码如下所示：
MyEdit.SetSel(-1,0); //取消正文的选择
MyEdit.ReplaceSel(“......”);

可以利用ReplaceSel清除编辑框中的正文，典型的代码如下所示：
MyEdit.SetSel(0,-1); //选择全部正文
MyEdit.ReplaceSel(“”);

在后面的小节中，读者将会看到使用编辑框的例子．

.1.5 滚动条控件

滚动条(Scroll Bar)主要用来从某一预定义值范围内快速有效地进行选择．滚动条分垂直滚动条和水平滚动条两种．在滚动条内有一个滚动框，用来表示当前的值．用鼠标单击滚动条，可以使滚动框移动一页或一行，也可以直接拖动滚动框．滚动条既可以作为一个独立控件存在，也可以作为窗口、列表框和组合框的一部分．Windows 95的滚动条支持比例滚动框，即用滚动框的大小来反映页相对于整个范围的大小．Windows 3.x使用单独的滚动条控件来调整调色板、键盘速度以及鼠标灵敏度，在Windows 95中，滚动条控件被轨道条取代（参见6.2.3）不提倡使用单独的滚动条控件．

需要指出的是，从性质上划分，滚动条可分为标准滚动条和滚动条控件两种．标准滚动条是由WS_HSCROLL或WS_VSCROLL风格指定的，它不是一个实际的窗口，而是窗口的一个组成部分（例如列表框中的滚动条），只能位于窗口的右侧（垂直滚动条）或底端（水平滚动条）．标准滚动条是在窗口的非客户区中创建的．与之相反，滚动条控件并不是窗口的一个零件，而是一个实际的窗口，可以放置在窗口客户区的任意地方，它既可以独立存在，也可以与某一个窗口组合，行使滚动窗口的职能．由于滚动条控件是一个独立窗口，因此可以拥有输入焦点，可以响应光标控制键，如PgUp、PgDown、Home和End．

MFC的CScrollBar类封装了滚动条控件．CScrollBar类的Create成员函数负责创建控件，该函数的声明为

BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );

参数dwStyle指定了控件的风格．rect说明了控件的位置和尺寸．pParentWnd指向父窗口，该参数不能为NULL。nID则说明了控件的ID。如果创建成功，该函数返回TRUE，否则返回FALSE．

要创建一个普通的水平滚动条控件，应指定风格WS_CHILD|WS_VISIBLE|BS_HORZ．要创建一个普通的垂直滚动条控件，应指定风格WS_CHILD|WS_VISIBLE|BS_VERT．

主要的CScrollBar类成员函数如下所示：

int GetScrollPos( ) const;
该函数返回滚动框的当前位置．若操作失败则返回0．

int SetScrollPos( int nPos, BOOL bRedraw = TRUE );
该函数将滚动框移动到指定位置．参数nPos指定了新的位置．参数bRedraw表示是否需要重绘滚动条，如果为TRUE，则重绘之．函数返回滚动框原来的位置．若操作失败则返回0．

void GetScrollRange( LPINT lpMinPos, LPINT lpMaxPos ) const;
该函数对滚动条的滚动范围进行查询．参数lpMinPos和lpMaxPos分别指向滚动范围的最小最大值．

void SetScrollRange( int nMinPos, int nMaxPos, BOOL bRedraw = TRUE );
该函数用于指定滚动条的滚动范围．参数nMinPos和nMaxPos分别指定了滚动范围的最小最大值．由这两者指定的滚动范围不得超过32767．当两者都为0时，滚动条将被隐藏．参数bRedraw表示是否需要重绘滚动条，如果为TRUE，则重绘之．

BOOL GetScrollInfo( LPSCROLLINFO lpScrollInfo, UINT nMask );
该函数用来获取滚动条的各种状态，包括滚动范围、滚动框的位置和页尺寸．参数lpScrollInfo指向一个SCROLLINFO结构，该结构如下所示：
typedef struct tagSCROLLINFO {
UINT cbSize; //结构的尺寸（字节为单位）
UINT fMask; /*说明结构中的哪些参数是有效的，可以是屏蔽值的组合， 如SIF_POS|SIF_PAGE，若为SIF_ALL则整个结构都有效*/
int nMin; //滚动范围最大值，当fMask中包含SIF_RANGE时有效
int nMax; //滚动范围最小值，当fMask中包含SIF_RANGE时有效
UINT nPage; /*页尺寸，用来确定比例滚动框的大小，当fMask中包含 SIF_PAGE时有效*/
int nPos; //滚动框的位置，当fMask中包含SIF_POS有效
int nTrackPos; /*拖动时滚动框的位置，当fMask中包含 SIF_TRACKPOS时有效，该参数只能查询，不能设 置，最好不要用该参数来查询拖动时滚动框的位置*/
} SCROLLINFO;
typedef SCROLLINFO FAR *LPSCROLLINFO;
参数nMask的意义与SCROLLINFO结构中的fMask相同．函数在获得有效值后返回TRUE，否则返回FALSE．

BOOL SetScrollInfo( LPSCROLLINFO lpScrollInfo, BOOL bRedraw = TRUE );
该函数用于设置滚动条的各种状态，一个重要用途是设定页尺寸从而实现比例滚动框．参数lpScrollInfo指向一个SCROLLINFO结构，参数bRedraw表示是否需要重绘滚动条，如果为TRUE，则重绘之．若操作成功，该函数返回TRUE，否则返回FALSE．

CWnd类也提供了一些函数来查询和设置所属的标准滚动条．这些函数与CScrollBar类的函数同名，且功能相同，但每个函数都多了一个参数，用来选择滚动条．例如，CWnd:: GetScrollPos 的声明为

int GetScrollPos( int nBar ) const;
参数nBar用来选择滚动条，可以为下列值：
SB_HORZ //指定水平滚动条
SB_VERT //指定垂直滚动条

无论是标准滚动条，还是滚动条控件，滚动条的通知消息都是用WM_HSCROLL和WM_VSCROLL消息发送出去的．对这两个消息的确省处理函数是CWnd::OnHScroll和CWnd::OnVScroll，它们几乎什么也不做．一般需要在派生类中对这两个函数从新设计，以实现滚动功能．这两个函数的声明为

afx_msg void OnHScroll( UINT nSBCode, UINT nPos, CScrollBar* pScrollBar );

afx_msg void OnVScroll( UINT nSBCode, UINT nPos, CScrollBar* pScrollBar );
参数nSBCode是通知消息码，如表6.8所示．nPos是滚动框的位置，只有在nSBCode为SB_THUMBPOSITION或SB_THUMBTRACK时，该参数才有意义．如果通知消息是滚动条控件发来的，那么pScrollBar是指向该控件的指针，如果是标准滚动条发来的，则pScrollBar为NULL．

表6.8　滚动条的通知消息码

6.1.8小节的例子中，读者将学会如何使用滚动条以及如何编写自己的OnHScroll函数．

6.1.6 列表框控件

列表框主要用于输入，它允许用户从所列出的表项中进行单项或多项选择，被选择的项呈高亮度显示．列表框具有边框，并且一般带有一个垂直滚动条．列表框分单选列表框和多重选择列表框两种．单选列表框一次只能选择一个列表项，而多重选择列表框可以进行多重选择．对于列表项的选择，微软公司有如下建议：

单击鼠标选择一个列表项，单击一个按钮来处理选择的项．

双击鼠标选择一个列表项是处理选择项的快捷方法．

列表框会向父窗口发送如表6.9所示的通知消息．

表6.9 列表框控件的通知消息

MFC的CListBox类封装了列表框．CListBox类的Create成员函数负责列表框的创建，该函数的声明是

BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );

参数dwStyle指定了列表框控件的风格，如表6.10所示，dwStyle可以是这些风格的组合．rect说明了控件的位置和尺寸．pParentWnd指向父窗口，该参数不能为NULL。nID则说明了控件的ID。如果创建成功，该函数返回TRUE，否则返回FALSE．

表6.10 列表框控件的风格

除了上表中的风格外，一般还要为列表框控件指定WS_CHILD、WS_VISIBLE、WS_TABSTOP、WS_BORDER和WS_VSCROLL风格．要创建一个普通的单选择列表框，应指定的风格为WS_CHILD|WS_VISIBLE|WS_TABSTOP|LBS_STANDARD．要创建一个多重选择列表框，应该在单选择列表框风格的基础上再加上 LBS_MULTIPLESEL或LBS_ EXTENDEDSEL．如果不希望列表框排序，就不能使用LBS_STANDARD风格．

对于用对话框模板编辑器创建的列表框控件，可以在控件的属性对话框中指定表6.10中列出的控件风格。例如，在属性对话框中选择Sort项，相当与指定了LBS_SORT风格。

CListBox类的成员函数有数十个之多．我们可以把一些常用的函数分为三类，在下面列出．需要说明的是，可以用索引来指定列表项，索引是从零开始的．

首先，CListBox成员函数提供了下列函数用于插入和删除列表项．

int AddString( LPCTSTR lpszItem );
该函数用来往列表框中加入字符串，其中参数lpszItem指定了要添加的字符串．函数的返回值是加入的字符串在列表框中的位置，如果发生错误，会返回LB_ERR或LB_ERRSPACE（内存不够）．如果列表框未设置LBS_SORT风格，那么字符串将被添加到列表的末尾，如果设置了LBS_SORT风格，字符串会按排序规律插入到列表中．

int InsertString( int nIndex, LPCTSTR lpszItem );
该函数用来在列表框中的指定位置插入字符串．参数nIndex给出了插入位置（索引），如果值为-1，则字符串将被添加到列表的末尾．参数lpszItem指定了要插入的字符串．函数返回实际的插入位置，若发生错误，会返回LB_ERR或LB_ERRSPACE．与AddString函数不同，InsertString函数不会导致LBS_SORT风格的列表框重新排序．不要在具有LBS_SORT风格的列表框中使用InsertString函数，以免破坏列表项的次序．

int DeleteString( UINT nIndex );
该函数用于删除指定的列表项，其中参数nIndex指定了要删除项的索引．函数的返回值为剩下的表项数目，如果nIndex超过了实际的表项总数，则返回LB_ERR．

void ResetContent( );
该函数用于清除所有列表项．

int Dir( UINT attr, LPCTSTR lpszWildCard );
该函数用来向列表项中加入所有与指定通配符相匹配的文件名或驱动器名．参数attr为文件类型的组合，如表6.11所示．参数lpszWildCard指定了通配符（如*.cpp，*.*等）．

表6.11 Dir函数attr参数的含义

下列的CListBox成员函数用于搜索、查询和设置列表框．

int GetCount( ) const;
该函数返回列表项的总数，若出错则返回LB_ERR．

int FindString( int nStartAfter, LPCTSTR lpszItem ) const;
该函数用于对列表项进行与大小写无关的搜索．参数nStartAfter指定了开始搜索的位置, 合理指定nStartAfter可以加快搜索速度，若nStartAfter为-1，则从头开始搜索整个列表．参数lpszItem指定了要搜索的字符串．函数返回与lpszItem指定的字符串相匹配的列表项的索引，若没有找到匹配项或发生了错误，函数会返回LB_ERR．FindString函数先从nStartAfter指定的位置开始搜索，若没有找到匹配项，则会从头开始搜索列表．只有找到匹配项，或对整个列表搜索完一遍后，搜索过程才会停止，所以不必担心会漏掉要搜索的列表项．

int GetText( int nIndex, LPTSTR lpszBuffer ) const;
void GetText( int nIndex, CString& rString ) const;
用于获取指定列表项的字符串．参数nIndex指定了列表项的索引．参数lpszBuffer指向一个接收字符串的缓冲区．引用参数rString则指定了接收字符串的CString对象．第一个版本的函数会返回获得的字符串的长度，若出错，则返回LB_ERR．

int GetTextLen( int nIndex ) const;
该函数返回指定列表项的字符串的字节长度．参数nIndex指定了列表项的索引．若出错则返回LB_ERR．

DWORD GetItemData( int nIndex ) const;
每个列表项都有一个32位的附加数据．该函数返回指定列表项的附加数据，参数nIndex指定了列表项的索引．若出错则函数返回LB_ERR．

int SetItemData( int nIndex, DWORD dwItemData );
该函数用来指定某一列表项的32位附加数据．参数nIndex指定了列表项的索引．dwItemData是要设置的附加数据值．

posted on 2007-10-19 14:38 大龙 阅读(5767) 评论(0)  编辑 收藏 引用