CCheckListBox, classe
Fournit les fonctionnalités d'une zone de liste de vérification windows.
class CCheckListBox : public CListBox
Membres
Constructeurs publics
Nom |
Description |
---|---|
Construit un objet CCheckListBox. |
Méthodes publiques
Nom |
Description |
---|---|
Crée la zone de liste de vérification windows et l'attache à l'objet d' CCheckListBox . |
|
Appelé par l'infrastructure lorsqu'un aspect visuel d'une zone de liste owner-draw change. |
|
Active ou désactive un élément de zone de liste de vérification. |
|
Obtient l'état de la case à cocher d'un élément. |
|
Obtient le style des cases à cocher du contrôle. |
|
Détermine si un élément est activé. |
|
Appelé par l'infrastructure lorsqu'une zone de liste avec un style owner draw est créée. |
|
Appelé par l'infrastructure pour obtenir la position de la case à cocher d'un élément. |
|
Définit l'état de la case à cocher d'un élément. |
|
Définit le style des cases à cocher du contrôle. |
Notes
Une « zone de liste de vérification » affiche une liste d'éléments, tels que des noms de fichiers. Chaque élément de la liste a une case à cocher en regard de celle-ci que l'utilisateur peut contrôler ou la suppression.
CCheckListBox est uniquement pour les contrôles owner-drawn parce que la liste contient plus que des chaînes de texte. Dans sa forme la plus simple, une zone de liste de vérification contient des chaînes de texte et cases à cocher, mais vous n'avez pas besoin d'avoir le texte du tout. Par exemple, vous pouvez avoir une liste de petites bitmap avec une case à cocher en regard de chaque élément.
Pour créer votre propre zone de liste de vérification, vous devez dériver votre propre classe d' CCheckListBox. Pour dériver votre propre classe, entrez un constructeur pour la classe dérivée, puis appelez Créer.
Si vous souhaitez gérer des messages de notification de fenêtres envoyés par une zone de liste à son parent (généralement une classe dérivée de CDialog), ajoutez une entrée de la table des messages et une fonction membre gestionnaire de messages à la classe parente pour chaque message.
Chaque entrée de la table des messages prend la forme suivante :
Notification**(id, memberFxn)**d'ON_
où id spécifie l'ID de fenêtre enfant de l'émission de contrôle la notification et memberFxn est le nom de la fonction membre parente que vous avez écrit pour traiter la notification.
Le prototype de fonction du parent est la suivante :
afx_msgvoidmemberFxn**( );**
Il existe une seule entrée de la table des messages concernant les contrôles spécifiquement CCheckListBox (mais voir les entrées de la table des messages pour CListBox) :
- ON_CLBN_CHKCHANGE l'utilisateur a modifié l'état de la case à cocher d'un élément.
Si votre zone de liste de vérification est une zone de liste de vérification par défaut (une liste de chaînes avec les cases à cocher de taille d'une valeur par défaut à gauche de chaque), vous pouvez utiliser la valeur par défaut CCheckListBox::DrawItem pour dessiner la zone de liste de vérification. Sinon, vous devez substituer la fonction de CListBox::CompareItem et CCheckListBox::DrawItem et CCheckListBox::MeasureItem s'exécute.
Vous pouvez créer une zone de liste de vérification d'un modèle de boîte de dialogue ou directement dans votre code.
Hiérarchie d'héritage
CCheckListBox
Configuration requise
En-tête : afxwin.h