CListBox::FindStringExact

Articolo
03/05/2013

Cercare la prima stringa della casella di riepilogo che corrisponde alla stringa specificata in lpszFind.

int FindStringExact(
   int nIndexStart,
   LPCTSTR lpszFind 
) const;

Parametri

nIndexStart
Specifica 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 nIndexStart.Se nIndexStart è a 1, l'intera casella di riepilogo viene trovato dall'inizio.
lpszFind
Punta alla stringa con terminazione null da cercare.Questa stringa può contenere un nome file completo, inclusa l'estensione.La ricerca non viene applicata la distinzione tra maiuscole e minuscole, pertanto la stringa può contenere qualsiasi combinazione di lettere maiuscole e minuscole.

Valore restituito

L'indice dell'elemento corrispondente, o LB_ERR se la ricerca ha esito negativo.

Note

Se la casella di riepilogo è stato creato con uno stile del disegno personalizzato senza lo stile LBS_HASSTRINGS, la funzione membro FindStringExact tenta di associare il valore dei primi quattro byte con il valore lpszFind.

Esempio

// The string to match.
LPCTSTR lpszmyString = _T("item string 3");

// Delete all items that exactly match the specified string.
int nIndex = 0;
while ((nIndex=m_myListBox.FindStringExact(nIndex, lpszmyString)) != LB_ERR)
{
   m_myListBox.DeleteString(nIndex);
}