CListBox::SelectString

Articolo
03/05/2013

Cerca un elemento della casella di riepilogo che corrisponde alla stringa specificata e se un elemento corrispondente viene trovato, selezionare l'elemento.

int SelectString(
   int nStartAfter,
   LPCTSTR lpszItem 
);

Parametri

nStartAfter
Contiene l'indice in base zero dell'elemento prima del primo elemento da cercare.Quando la ricerca raggiunge la fine della casella di riepilogo, continua dalla parte superiore della casella di riepilogo dell'elemento specificato da nStartAfter.Se nStartAfter è a 1, l'intera casella di riepilogo viene trovato dall'inizio.
lpszItem
Punta alla stringa con terminazione null che contiene il prefisso per trovare.La ricerca viene eseguito senza distinzione tra maiuscole e minuscole, questa stringa può contenere qualsiasi combinazione di lettere maiuscole e minuscole.

Valore restituito

L'indice dell'elemento selezionato se la ricerca è stata completata.Se la ricerca ha esito negativo, il valore restituito è LB_ERR e la selezione corrente non viene modificata.

Note

La casella di riepilogo viene scorsa se necessario, per inserire l'elemento selezionato nella visualizzazione.

Questa funzione membro non può essere utilizzata con una casella di riepilogo con lo stile LBS_MULTIPLESEL.

Viene selezionato un elemento solo se i caratteri iniziali (il punto iniziale) corrispondono ai caratteri della stringa specificata da lpszItem.

Utilizzare la funzione membro FindString per trovare una stringa senza selezionare l'elemento.

Esempio

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