CVSListBox, classe
La CVSListBox classe prend en charge un contrôle de liste modifiable.
Syntaxe
class CVSListBox : public CVSListBoxBase
Membres
Constructeurs publics
| Nom | Description |
|---|---|
| CVSListBox ::CVSListBox | Construit un objet CVSListBox. |
CVSListBox::~CVSListBox |
Destructeur. |
Méthodes publiques
| Nom | Description |
|---|---|
| CVSListBox ::AddItem | Ajoute une chaîne à un contrôle de liste. (Substitue CVSListBoxBase::AddItem.) |
| CVSListBox ::EditItem | Démarre une opération de modification sur le texte d’un élément de contrôle de liste. (Substitue CVSListBoxBase::EditItem.) |
| CVSListBox ::GetCount | Récupère le nombre de chaînes dans un contrôle de liste modifiable. (Substitue CVSListBoxBase::GetCount.) |
| CVSListBox ::GetItemData | Récupère une valeur 32 bits spécifique à l’application associée à un élément de contrôle de liste modifiable. (Substitue CVSListBoxBase::GetItemData.) |
| CVSListBox ::GetItemText | Récupère le texte d’un élément de contrôle de liste modifiable. (Substitue CVSListBoxBase::GetItemText.) |
| 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. (Substitue CVSListBoxBase::GetSelItem.) |
CVSListBox::PreTranslateMessage |
Traduit les messages de fenêtre avant qu’ils ne soient distribués aux fonctions Windows TranslateMessage et DispatchMessage . Pour plus d’informations et la syntaxe de méthode, consultez CWnd ::P reTranslateMessage. (Substitue CVSListBoxBase::PreTranslateMessage.) |
| CVSListBox ::RemoveItem | Supprime un élément d’un contrôle de liste modifiable. (Substitue CVSListBoxBase::RemoveItem.) |
| CVSListBox ::SelectItem | Sélectionne une chaîne de contrôle de liste modifiable. (Substitue CVSListBoxBase::SelectItem.) |
| CVSListBox ::SetItemData | Associe une valeur 32 bits spécifique à l’application à un élément de contrôle de liste modifiable. (Substitue CVSListBoxBase::SetItemData.) |
Méthodes protégées
| Nom | Description |
|---|---|
| CVSListBox ::GetListHwnd | Retourne le handle au contrôle d’affichage de liste incorporé actuel. |
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
CVSListBoxBase
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour