CListBox::CharToItem

virtual int CharToItem (UINT nKey, UINT nIndex );

Valeur de retour

Retur&nsnbsp ; -1 ou – 2 pour aucune autre action ou d'un nombre non négatif pour spécifier un index d'un élément de zone de liste sur lequel effectuer l'action par défaut pour la frappe. L'implémentation par défaut retourne-1.

Paramètres

nKey

Le caractère que l'utilisateur a tapé le code ANSI.

nIndex

La position actuelle du signe d'insertion de zone de liste.

Remarques

Cette fonction est appelée par l'infrastructure lors de la fenêtre parent de la zone de liste reçoit un message WM_CHARTOITEM dans la zone de liste. Le message WM_CHARTOITEM est envoyé par la zone de liste lorsqu'il reçoit un message WM_CHAR , mais seulement si la zone de liste répond à tous ces critères:

Vous devez jamais appeler cette fonction vous-même. Substituer cette fonction pour fournir votre propre gestion personnalisée des messages de clavier.

Da&ns votre priorité, vous devez retourner une valeur pour dire le cadre de l'action que vous avez effectué. Un ofnbsp de valeur de retour ; -1 ou -2 indique que vous géré tous les aspects de la sélection de l'élément et qu'il ne nécessite aucune action supplémentaire de la zone de liste. Avant de retourner-1 ou – 2, vous pourriez définir la sélection ou déplacer le signe insertion ou les deux. Pour définir la sélection, utilisez SetCurSel ou SetSel. Pour déplacer le signe insertion, utilisez SetCaretIndex.

Une valeur de 0 ou plus de retour spécifie l'index d'un élément dans la zone de liste et indique que la zone de liste doit effectuer l'action par défaut pour la frappe sur l'élément donné.

Aperçu de CListBox |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CListBox::VKeyToItem, CListBox::SetCurSel, CListBox::SetSel, CListBox::SetCaretIndex, WM_CHARTOITEM

Index