按键盘上方向键 ← 或 → 可快速上下翻页，按键盘上的 Enter 键可回到本书目录页，按键盘上方向键 ↑ 可回到本页顶部！
————未阅读完？加入书签已便下次继续阅读！
void ResetContent（）；
该函数用于清除所有列表项。
5 ．GetCount（）函数
该成员函数声明如下：
int GetCount（） const；
该函数返回列表项的总数，若出错则返回 LB_ERR 。
·119 ·
…………………………………………………………Page 129……………………………………………………………
Visual C＋＋ 6。0 程序设计从入门到精通
6 ．FindString（） 函数
该成员函数声明如下：
int FindString（int nStartAfter；LPCTSTR lpszItem） const；
该函数用于对列表项进行与大小写无关的搜索。参数 nStartAfter 指定了开始搜索的位置；
合理指定 nStartAfter 可以加快搜索速度，若 nStartAfter 为…1，则从头开始搜索整个列表。参
数 lpszItem 指定了要搜索的字符串。函数返回与 lpszItem 指定的字符串相匹配的列表项的索
引，若没有找到匹配项或发生了错误，则会返回 LB_ERR 。FindString 函数先从 nStartAfter
指定的位置开始搜索，若没有找到匹配项，则会从头开始搜索列表。只有找到匹配项，或对
整个列表搜索完一遍后，搜索过程才会停止，所以不必担心会漏掉要搜索的列表项。
7 ．GetText（）函数
该成员函数声明如下：
int GetText（int nIndex；LPTSTR lpszBuffer） const；
void GetText（int nIndex；CString& rString） const；
这两个成员函数用于获取指定列表项的字符串 。参数 nIndex 指定了列表项的索引。参数
lpszBuffer 指向一个接收字符串的缓冲区 。引用参数 rString 则指定了接收字符串的 CString 对
象。第一个版本的函数会返回获得的字符串的长度，若出错，则返回 LB_ERR ；第二个版本
的函数则不会。
8．GetTextLen（）函数
该成员函数声明如下：
int GetTextLen（int nIndex） const；
该函数返回指定列表项的字符串的字节长度。参数 nIndex 指定了列表项的索引 。若出错
则返回 LB_ERR 。
9 ．GetItemData（）函数
该成员函数声明如下：
DWORD GetItemData（int nIndex） const；
每个列表项都有一个 32 位的附加数据 。该函数返回指定列表项的附加数据，参数 nIndex
指定了列表项的索引。若出错则函数返回 LB_ERR 。
10．SetItemData（）函数
该成员函数声明如下：
int SetItemData（int nIndex； DWORD dwItemData）；
该函数用来指定某一列表项的 32 位附加数据。参数 nIndex 指定了列表项的索引。
dwItemData 是要设置的附加数据值。
11．GetSel（）函数
该成员函数声明如下：
·120 ·
…………………………………………………………Page 130……………………………………………………………
第 5 章 常用控件
int GetSel（int nIndex） const；
该函数返回指定列表项的状态。参数 nIndex 指定了列表项的索引 。如果查询的列表项被
选择了，函数返回一个正值，否则返回 0，若出错则返回 LB_ERR 。
12．GetCurSel（）函数
该成员函数声明如下：
int GetCurSel（） const；
该函数仅适用于单选择列表框，用来返回当前被选择项的索引，如果没有列表项被选择
或有错误发生，则函数返回 LB_ERR 。
13．SetCurSel（）函数
该成员函数声明如下：
int SetCurSel（int nSelect）；
该函数仅适用于单选择列表框，用来选择指定的列表项。该函数会滚动列表框以使选择
项可见。参数 nIndex 指定了列表项的索引，若为…1，那么将清除列表框中的选择。若出错函
数返回 LB_ERR 。
14．SelectString（）函数
该成员函数声明如下：
int SelectString（int nStartAfter；LPCTSTR lpszItem）；
该函数仅适用于单选择列表框，用来选择与指定字符串相匹配的列表项。该函数会滚动
列表框以使选择项可见。参数的意义及搜索的方法与函数 FindString 类似。如果找到了匹配
的项，函数返回该项的索引，如果没有匹配的项，函数返回 LB_ERR 并且当前的选择不被改
变。
15．GetSelCount（）函数
该成员函数声明如下：
int GetSelCount（） const；
该函数仅用于多重选择列表框，它返回选择项的数目，若出错函数返回 LB_ERR 。
16．SetSel（）函数
该成员函数声明如下：
int SetSel（int nIndex；BOOL bSelect = TRUE）；
该函数仅适用于多重选择列表框，它使指定的列表项选中或落选。参数 nIndex 指定了列
表项的索引，若为…1，则相当于指定了所有的项。参数 bSelect 为 TRUE 时选中列表项，否则
使之落选。若出错则返回 LB_ERR 。
17．GetSelItems（）函数
该成员函数声明如下：
int GetSelItems（int nMaxItems； LPINT rgIndex） const；
·121 ·
…………………………………………………………Page 131……………………………………………………………
Visual C＋＋ 6。0 程序设计从入门到精通
该函数仅用于多重选择列表框，用来获得选中的项的数目及位置。参数 nMaxItems 说明
了参数 rgIndex 指向的数组的大小。参数 rgIndex 指向一个缓冲区，该数组是一个整型数组，
用来存放选中的列表项的索引。函数返回放在缓冲区中的选择项的实际数目，若出错函数返
回 LB_ERR 。
18．SetItemRange（）函数
该成员函数声明如下：
int SetItemRange（BOOL bSelect；int nFirstItem；int nLastItem）；
该函数仅用于多重选择列表框，用来使指定范围内的列表项选中或落选。参数 nFirstItem
和 nLastItem 指定了列表项索引的范围 。如果参数 bSelect 为 TRUE，那么就选择这些列表项，
否则就使它们落选。若出错函数返回 LB_ERR 。
技巧：实现列表框的提示条（可以显示完整的列表框的项目文本）
用一个 CListBox 派生类实现宿主（owner…draw ）列表框，这个列表框的项目宽度超过了列表框本身
的宽度，因此当鼠标指针指向大宽度的列表框项时，希望显示一个类似 Toolbar 的提示窗口，在窗口
中显示完整的列表框项目文本。
附带光盘下的工程演示列表框提示条的实现，主要是创建了可重用窗口类 CPopupText 。
CPopupText 类会根据提示文本的长度自己决定弹出窗口的大小。它的字体默认值与状态行显示字体
相同（由 SystemParametersInfo（SPI_GETNONCLIENTMETRICS）返回的 NONCLIENTMETRICS 结构
成员 lfStatusFont 定义），设置 SW_SHOWNA 是很重要的，因为你不想使提示窗口为活动窗口，而
只是显示它。另外，CPopupText 还提供一个专门的函数 CPopupText：：ShowDelayed，它的功能是在显
示提示窗口之前设置一个毫秒级延时，如果延时为零，则立刻显示提示窗口，你可以使用这个特点来
替代对 ShowWindow 的调用。如果要隐藏提示窗口或取消 ShowDelayed，