CVSListBox, classe

La CVSListBox classe prend en charge un contrôle de liste modifiable.

Syntaxe

class CVSListBox : public CVSListBoxBase

Membres

Constructeurs publics

Méthodes publiques

Méthodes protégées

Notes

La CVSListBox classe fournit un ensemble de boutons d’édition qui permettent à l’utilisateur de créer, modifier, supprimer ou réorganiser les éléments d’un contrôle de liste.

Voici une image du contrôle de liste modifiable. La deuxième entrée de liste, intitulée « Item2 », est sélectionnée pour modification.

Si vous utilisez l’éditeur de ressources pour ajouter un contrôle de liste modifiable, notez que le volet Boîte à outils de l’éditeur ne fournit pas de contrôle de liste modifiable prédéfini. Au lieu de cela, ajoutez un contrôle statique tel que le contrôle Group Box . L’infrastructure utilise le contrôle statique comme espace réservé pour spécifier la taille et la position du contrôle de liste modifiable.

Pour utiliser un contrôle de liste modifiable dans un modèle de boîte de dialogue, déclarez une CVSListBox variable dans votre classe de boîte de dialogue. Pour prendre en charge l’échange de données entre la variable et le contrôle, définissez une DDX_Control entrée de macro dans la DoDataExchange méthode de la boîte de dialogue. Par défaut, le contrôle de liste modifiable est créé sans boutons d’édition. Utilisez la méthode CVSListBoxBase ::SetStandardButtons héritée pour activer les boutons de modification.

Pour plus d’informations, consultez le répertoire Samples, l’exemple New Controls , les fichiers Page3.cpp et Page3.h.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CStatic

CVSListBoxBase

CVSListBox

Spécifications

En-tête : afxvslistbox.h

CVSListBox ::AddItem

Ajoute une chaîne à un contrôle de liste.

virtual int AddItem(
    const CString& strIext,
    DWORD_PTR dwData=0,
    int iIndex=-1);

Paramètres

strIext
[in] Référence à une chaîne.

dwData
[in] Valeur 32 bits spécifique à l’application associée à la chaîne. La valeur par défaut est 0.

iIndex
[in] Index de base zéro de la position qui contiendra la chaîne. Si le paramètre iIndex est -1, la chaîne est ajoutée à la fin de la liste. La valeur par défaut est -1.

Valeur de retour

Index de base zéro de la position de la chaîne dans le contrôle de liste.

Notes

Utilisez la méthode CVSListBox ::GetItemData pour récupérer la valeur spécifiée par le paramètre dwData . Cette valeur peut être un entier spécifique à l’application ou un pointeur vers d’autres données.

CVSListBox ::CVSListBox

Construit un objet CVSListBox.

CVSListBox();

Valeur de retour

Notes

CVSListBox ::EditItem

Démarre une opération de modification sur le texte d’un élément de contrôle de liste.

virtual BOOL EditItem(int iIndex);

Paramètres

iIndex
[in] Index de base zéro d’un élément de contrôle de liste.

Valeur de retour

TRUE si l’opération de modification démarre correctement ; sinon, FALSE.

Notes

L’utilisateur démarre une opération de modification en double-cliquant sur l’étiquette d’un élément ou en appuyant sur la touche F2 ou SPACEBAR lorsqu’un élément a le focus.

CVSListBox ::GetCount

Récupère le nombre de chaînes dans un contrôle de liste modifiable.

virtual int GetCount() const;

Valeur de retour

Nombre d'éléments figurant dans le contrôle de liste.

Notes

Notez que le nombre est supérieur à la valeur d’index du dernier élément, car l’index est de base zéro.

CVSListBox ::GetItemData

Récupère une valeur 32 bits spécifique à l’application associée à un élément de contrôle de liste modifiable.

virtual DWORD_PTR GetItemData(int iIndex) const;

Paramètres

iIndex
[in] Index de base zéro d’un élément de contrôle de liste modifiable.

Valeur de retour

Valeur 32 bits associée à l’élément spécifié.

Notes

Utilisez la méthode CVSListBox ::SetItemData ou CVSListBox ::AddItem pour associer la valeur 32 bits à l’élément de contrôle de liste. Cette valeur peut être un entier spécifique à l’application ou un pointeur vers d’autres données.

CVSListBox ::GetItemText

Récupère le texte d’un élément de contrôle de liste modifiable.

virtual CString GetItemText(int iIndex) const;

Paramètres

iIndex
[in] Index de base zéro d’un élément de contrôle de liste modifiable.

Valeur de retour

Objet CString qui contient le texte de l’élément spécifié.

Notes

CVSListBox ::GetListHwnd

Retourne le handle au contrôle d’affichage de liste incorporé actuel.

virtual HWND GetListHwnd() const;

Valeur de retour

Handle vers le contrôle d’affichage de liste incorporé.

Notes

Utilisez cette méthode pour récupérer un handle dans le contrôle d’affichage de liste incorporé qui prend en charge la CVSListBox classe.

CVSListBox ::GetSelItem

Récupère l’index de base zéro de l’élément actuellement sélectionné dans un contrôle de liste modifiable.

virtual int GetSelItem() const;

Valeur de retour

Si cette méthode réussit, l’index de base zéro de l’élément actuellement sélectionné ; sinon, -1.

Notes

CVSListBox ::RemoveItem

Supprime un élément d’un contrôle de liste modifiable.

virtual BOOL RemoveItem(int iIndex);

Paramètres

iIndex
[in] Index de base zéro d’un élément de contrôle de liste modifiable.

Valeur de retour

TRUE si l’élément spécifié est supprimé ; sinon, FALSE.

Notes

CVSListBox ::SelectItem

Sélectionne une chaîne de contrôle de liste modifiable.

virtual BOOL SelectItem(int iItem);

Paramètres

iItem
[in] Index de base zéro d’un élément de contrôle de liste modifiable.

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE.

Notes

Cette méthode sélectionne l’élément spécifié et, s’il est nécessaire, fait défiler l’élément en mode affichage.

CVSListBox ::SetItemData

Associe une valeur 32 bits spécifique à l’application à un élément de contrôle de liste modifiable.

virtual void SetItemData(
    int iIndex,
    DWORD_PTR dwData);

Paramètres

iIndex
[in] Index de base zéro d’un élément de contrôle de liste modifiable.

dwData
[in] Valeur 32 bits. Cette valeur peut être un entier spécifique à l’application ou un pointeur vers d’autres données.

Notes

Voir aussi

Graphique hiérarchique
Classes