Partager via


CListBox::SelectString

Les recherches d'un élément de zone de liste qui correspond à la chaîne spécifiée, et si un élément correspondant est trouvé, il sélectionne l'élément.

int SelectString( 
   int nStartAfter, 
   LPCTSTR lpszItem  
);

Paramètres

  • nStartAfter
    Contient l'index de base zéro de l'élément avant le premier élément à rechercher. Lorsque la recherche atteint le bas de la zone de liste, elle continue du supérieur de la zone de liste vers l'élément spécifié par nStartAfter. Si nStartAfter est à 1, la zone de liste entière est trouvé de début.

  • lpszItem
    Pointe vers la chaîne terminée par le caractère NULL qui contient le préfixe pour rechercher. La recherche est distinguant ne pas la casse par conséquent, cette chaîne peut contenir n'importe quelle combinaison de majuscules et des minuscules.

Valeur de retour

L'index de l'élément sélectionné si la recherche a abouti. Si la recherche est infructueuse, la valeur de retour est LB_ERR et la sélection actuelle n'est pas modifiée.

Notes

La zone de liste vous faites est si nécessaire, pour introduire l'élément sélectionné dans la vue.

Cette fonction membre ne peut pas être utilisé dans une zone de liste comportant le style de LBS_MULTIPLESEL .

Un élément est sélectionné uniquement si ses caractères initiaux (du point de départ) correspondent aux caractères dans la chaîne spécifiée par lpszItem.

Utilisez la fonction membre d' FindString pour rechercher une chaîne sans sélectionner l'élément.

Exemple

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

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CListBox, classe

Graphique de la hiérarchie

CListBox::FindString

LB_SELECTSTRING