CListBox

La classe CListBox fournit les fonctionnalités d'une zone de liste de Windows. Une zone de liste affiche une liste d'éléments, tels que les noms de fichiers que l'utilisateur peut afficher et sélectionner.

Dans une zone de liste à sélection unique, l'utilisateur peut sélectionner un seul élément. Dans une zone de liste à sélection multiple, une plage d'éléments peut être sélectionnée. Lorsque l'utilisateur sélectionne un élément, il est mis en surbrillance et la zone de liste envoie un message de notification à la fenêtre parent.

Vous pouvez créer une zone de liste à partir d'un modèle de boîte de dialogue ou directement dans votre code. Pour créer directement, construire l'objet CListBox , puis appelez la fonction membre Create pour créer le contrôle de zone de liste Windows et le joindre à l'objet de CListBox . Pour utiliser une zone de liste dans un modèle de boîte de dialogue, déclarez une variable de la zone de liste dans votre classe de boîte de dialogue, puis utilisez DDX_Control en fonction de votre classe de boîte de dialogue DoDataExchange pour connecter le contrôle de la variable de membre. (ClassWizard fait cela pour vous automatiquement lorsque vous ajoutez une variable de contrôle à votre classe de boîte de dialogue.)

Construction peut être un processus en une étape dans une classe dérivée de CListBox. Écrire un constructeur pour la classe dérivée et appeler le constructeur créer de.

Si vous souhaitez gérer les messages de notification de Windows envoyés par une zone de liste à son parent (généralement une classe dérivée de CDialog), ajouter une fonction de membre de message-carte entrée et gestionnaire de messages pour la classe parente pour chaque message.

Chaque entrée de la carte-message prend la forme suivante:

ON_Notification()id,memberFxn)

où id spécifie l'ID de fenêtre enfant du contrôle zone de liste envoi de la notification et memberFxn est le nom de la fonction de membre parent que vous avez écrit pour gérer la notification.

Voici le prototype de la fonction du parent:

afx_msg void memberFxn( );

Voici une liste de possibles entrées de message-carte et une description des cas où ils seraient envoyés au parent:

• ON_LBN_DBLCLKnbsp ;  L'utilisateur double-clique sur une chaîne dans une zone de liste. Seulement une zone de liste qui a le style LBS_NOTIFY enverra ce message de notification. & nbsp;
  
  
• O&N_LBN_ERRSPACEnbsp ;  La zone de liste ne peut pas allouer suffisamment de mémoire pour répondre à la demande.
  
  
• O&N_LBN_KILLFOCUSnbsp ;  La zone de liste perd le focus d'entrée.
  
  
• O&N_LBN_SELCANCELnbsp ;  La sélection de la zone de liste actuelle est annulée. Ce message est envoyé uniquement lorsqu'une zone de liste a le style LBS_NOTIFY.
  
  
• O&N_LBN_SELCHANGEnbsp ;  La sélection dans la zone de liste est sur le point de changer. Cette notification n'est pas envoyée si la sélection est modifiée par la fonction membre CListBox::SetCurSel . Cet avis s'applique uniquement à une zone de liste qui a le style LBS_NOTIFY . Le message de notification LBN_SELCHANGE est envoyé pour une zone de liste à sélection multiple chaque fois que l'utilisateur appuie sur une touche, même si la sélection ne change pas.
  
  
• O&N_LBN_SETFOCUSnbsp ;  La zone de liste reçoit le focus d'entrée.
  
  
• O&N_WM_CHARTOITEMnbsp ;  Une zone de liste owner-draw n'a aucune chaînes reçoit un message WM_CHAR.
  
  
• O&N_WM_VKEYTOITEMnbsp ;  Une zone de liste avec le style LBS_WANTKEYBOARDINPUT reçoit un message WM_KEYDOWN.

Si vous créez un objet de CListBox dans une boîte de dialogue (grâce à une ressource de boîte de dialogue), l'objet de CListBox est détruit automatiquement lorsque l'utilisateur ferme la boîte de dialogue.

Si vous créez un objet de CListBox dans une fenêtre, vous devrez détruire l'objet CListBox . Si vous créez l'objet CListBox sur la pile, il est détruit automatiquement. Si vous créez l'objet CListBox sur le tas à l'aide de la nouvelle fonction, vous devez appeler delete de l'objet à détruire lorsque l'utilisateur ferme la fenêtre parent.

Si vous allouez de la mémoire de l'objet CListBox , substituez le destructeur de CListBox pour disposer de l'allocation.

# include lt;afxwin.h>

Membres de la classe |  ; Classe de base | Graphique de la hiérarchie

Écha&ntillonnbsp ; Exemple MFC CTRLTEST

Voir aussi  ;CWnd, CButton, CComboBox, CEdit, CScrollBar, CStatic