CListBox::SelectString

Artykuł
02/27/2013

Wyszukiwanie elementu pola listy, które odpowiadają określonym ciągiem znaków, i jeśli znajdzie pasujący element, go zaznacza element.

int SelectString(
   int nStartAfter,
   LPCTSTR lpszItem 
);

Parametry

nStartAfter
Zawiera wyświetlanego elementu przed pierwszym mają być przeszukiwane.Podczas wyszukiwania osiągnie u dołu pola listy, kontynuuje od góry pola listy do element określony przez nStartAfter.Jeśli nStartAfter jest –1, pole listy jest przeszukiwany od początku.
lpszItem
Wskazuje ciąg zakończony znakiem null zawiera prefiks do wyszukiwania.Wyszukiwanie jest sprawa niezależne, więc ten ciąg może zawierać żadnych kombinacji wielkich i małych liter.

Wartość zwracana

Indeks wybranego elementu, jeśli wyszukiwanie zostało zakończone pomyślnie.Jeśli wyszukiwanie nie powiodło się, zwracana jest wartość LB_ERR i bieżące zaznaczenie nie ulega zmianie.

Uwagi

Pole listy jest przewijane, jeśli to konieczne przenieść zaznaczony element do widoku.

Nie można używać tej funkcji Członkowskich z pola listy, który ma LBS_MULTIPLESEL styl.

Element jest zaznaczony, tylko jeżeli jego początkowej znaków (od punktu początkowego) odpowiada znaków w ciągu określonego przez lpszItem.

Użyj FindString Członkowskich funkcji Wyszukiwanie ciągu bez wybierania towaru.

Przykład

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