CListBox::SelectString

搜索与指定字符串匹配的列表框中,项目,并且,如果找到匹配的项,则选择该项。

int SelectString(
   int nStartAfter,
   LPCTSTR lpszItem 
);

参数

  • nStartAfter
    在要搜索的第一项之前包含项的从零开始的索引。 在搜索到达列表框的底部时,它从列表框的顶部继续回 nStartAfter指定的项。 如果 nStartAfter 为– 1,整个列表框从开始处搜索。

  • lpszItem
    指向包含标题搜索的Null终止的字符串。 搜索区分大小写的,因此,此字符串可以包含大写和小写字母的任意组合。

返回值

选定项的索引,如果搜索成功。 如果搜索不成功,则返回值是 LB_ERR,并且不更改当前选择。

备注

列表框如果需要,移动,将选定的项视图。

此成员函数不能使用具有 LBS_MULTIPLESEL 样式的列表框。

项时,仅在其初始字符(从起点)与 lpszItem在字符串的字符指定的。

使用 FindString 成员函数查找字符串,而无需选择项目。

示例

// The string to match.
LPCTSTR lpszmyString = _T("item 5");

// Select the item that begins with the specified string.
int nIndex = m_myListBox.SelectString(0, lpszmyString);
ASSERT(nIndex != LB_ERR);

要求

Header: afxwin.h

请参见

参考

CListBox选件类

层次结构图

CListBox::FindString

LB_SELECTSTRING