Partager via


CCheckListBox, classe

Fournit les fonctionnalités d'une zone de liste de vérification windows.

class CCheckListBox : public CListBox

Membres

Constructeurs publics

Nom

Description

CCheckListBox::CCheckListBox

Construit un objet CCheckListBox.

Méthodes publiques

Nom

Description

CCheckListBox::Create

Crée la zone de liste de vérification windows et l'attache à l'objet d' CCheckListBox .

CCheckListBox::DrawItem

Appelé par l'infrastructure lorsqu'un aspect visuel d'une zone de liste owner-draw change.

CCheckListBox::Enable

Active ou désactive un élément de zone de liste de vérification.

CCheckListBox::GetCheck

Obtient l'état de la case à cocher d'un élément.

CCheckListBox::GetCheckStyle

Obtient le style des cases à cocher du contrôle.

CCheckListBox::IsEnabled

Détermine si un élément est activé.

CCheckListBox::MeasureItem

Appelé par l'infrastructure lorsqu'une zone de liste avec un style owner draw est créée.

CCheckListBox::OnGetCheckPosition

Appelé par l'infrastructure pour obtenir la position de la case à cocher d'un élément.

CCheckListBox::SetCheck

Définit l'état de la case à cocher d'un élément.

CCheckListBox::SetCheckStyle

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

CObject

CCmdTarget

CWnd

CListBox

CCheckListBox

Configuration requise

En-tête : afxwin.h

Voir aussi

Référence

CListBox, classe

Graphique de la hiérarchie

CListBox, classe

Concepts

MFC exemple TSTCON