CListBox::FindStringExact

Artikel
02/26/2013

Sucht die erste Listenfeldzeichenfolge, die die Zeichenfolge entspricht, die in lpszFind angegeben wird.

int FindStringExact(
   int nIndexStart,
   LPCTSTR lpszFind 
) const;

Parameter

nIndexStart
Gibt den nullbasierten Index des Elements vor dem gefunden werden an ersten Punkt.Wenn die Suche das Ende des Listenfelds erreicht, wird sie vom oberen Rand des Listenfelds zurück zu dem Element fort, das von nIndexStart angegeben wird.Wenn nIndexStart ist - 1, das gesamte Listenfeld wird vom Anfang gefunden.
lpszFind
Punkte auf NULL endende Zeichenfolge zu suchen.Diese Zeichenfolge kann einen vollständigen Namen, einschließlich der Erweiterung enthalten.Die Suche wird die Groß-/Kleinschreibung nicht beachtet, sodass die Zeichenfolge eine beliebige Kombination aus Buchstaben enthalten in Groß- und Kleinschreibung.

Rückgabewert

Der Index des entsprechenden Elements oder LB_ERR, wenn die Suche fehlgeschlagen ist.

Hinweise

Wenn das Listenfeld mit einem Ownerdrawnformat jedoch ohne das LBS_HASSTRINGS Format erstellt wurde, versucht die FindStringExact-Memberfunktion, den Doppelwortwert an den Wert von lpszFind anzupassen.

Beispiel

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