CListBox::SelectString

發行項
02/28/2013

搜尋符合指定之字串的清單方塊項目，，而且，如果找不到符合項目時，就會選取該項目。

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);