Freigeben über


CComboBox::SelectString

Sucht eine Zeichenfolge im Listenfeld eines Kombinationsfelds und wenn die Zeichenfolge gefunden wird, wählt die Zeichenfolge im Listenfeld und kopiert sie in Bearbeitungssteuerelement.

int SelectString( 
   int nStartAfter, 
   LPCTSTR lpszString  
);

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 - 1, das gesamte Listenfeld wird vom Anfang gefunden.

  • lpszString
    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 eine beliebige Kombination aus Buchstaben enthalten in Groß- und Kleinschreibung.

Rückgabewert

Der nullbasierte Index des ausgewählten Elements, wenn die Zeichenfolge gefunden wurde. Wenn die Suche nicht erfolgreich war, ist der Rückgabewert CB_ERR und die aktuelle Auswahl wird nicht geändert.

Hinweise

Eine Zeichenfolge wird ausgewählt, wenn nur die ersten Zeichen (vom Anfangspunkt) die Zeichen in der Präfixzeichenfolge übereinstimmen.

Beachten Sie, dass die SelectString und FindString-Memberfunktionen beide eine Zeichenfolge suchen, die SelectString-Memberfunktion wählt auch die Zeichenfolge aus.

Beispiel

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

// Select the item that begins with the specified string. 
int nSel = m_pComboBox->SelectString(0, lpszSelect);
ASSERT(nSel != CB_ERR);

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CComboBox-Klasse

Hierarchiediagramm

CComboBox::FindString

CB_SELECTSTRING