CListBox::SelectString
搜尋符合指定之字串的清單方塊項目,,而且,如果找不到符合項目時,就會選取該項目。
int SelectString(
int nStartAfter,
LPCTSTR lpszItem
);
參數
nStartAfter
in 要搜尋第一個項目之前包含項目之以零起始的索引。 當搜尋到達清單方塊下方時,它會從清單方塊頂端繼續回 nStartAfter指定的項目。 如果 nStartAfter 為– 1,整個清單方塊從開始搜尋。lpszItem
out 包含前置詞搜尋的 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