CListBox::SelectString
Suchen nach einem Listenfeldelement, das die angegebene Zeichenfolge übereinstimmt und wenn ein entsprechendes Element gefunden wird, wählt es das Element aus.
int SelectString(
int nStartAfter,
LPCTSTR lpszItem
);
Parameter
nStartAfter
Enthält den nullbasierten Index des Elements vor dem ersten Punkt gefunden werden. Wenn die Suche das Ende des Listenfelds erreicht, wird sie vom oberen Rand des Listenfelds zurück zu dem Element fort, das von nStartAfter angegeben wird. Wenn nStartAfter ist - 1, das gesamte Listenfeld wird vom Anfang gefunden.lpszItem
Zeigt die auf auf NULL endende Zeichenfolge, die das Präfix enthält, um zu suchen. Die Suche wird von Groß- und Kleinbuchstaben unabhängig, sodass diese Zeichenfolge enthält möglicherweise eine beliebige Kombination von Groß- und Kleinbuchstaben.
Rückgabewert
Der Index des ausgewählten Elements, wenn die Suche erfolgreich war. Wenn die Suche nicht erfolgreich war, ist der Rückgabewert LB_ERR und die aktuelle Auswahl wird nicht geändert.
Hinweise
Im Listenfeld wird ggf. gescrollt, um das ausgewählte Element in Ansicht zu bringen.
Diese Memberfunktion kann nicht mit einem Listenfeld verwendet werden, das das LBS_MULTIPLESEL Format hat.
Ein Element wird ausgewählt, wenn nur die ersten Zeichen (vom Anfangspunkt) die Zeichen in der Zeichenfolge übereinstimmen, die von lpszItem angegeben wird.
Verwenden Sie die FindString-Memberfunktion, um eine Zeichenfolge suchen, ohne das Element auszuwählen.
Beispiel
// 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);
Anforderungen
Header: afxwin.h