La classe CListCtrl encapsule la fonctionnalité d'un « contrôle list view,"qui affiche une collection d'éléments composés chacun d'une icône (par une liste d'images) et une étiquette. En plus de l'icône et l'étiquette, chaque élément peut avoir des informations affichées dans les colonnes à droite de l'icône et l'étiquette. Ce contrôle (et donc la classe CListCtrl ) sont disponible seulement pour les programmes qui s'exécutent sous Windows 95 et Windows NT version 3.51 ou ultérieure.
Voici un bref aperçu de la classe CListCtrl . Pour une discussion détaillée, conceptuelle, voir à l'aide de CListCtrl et Sujets de contrôle dans le Guide du programmeur Visual C++.
Affichage
Contrôles d'affichage de liste peuvent afficher le contenu de quatre manières différentes, appelés « points de vue. »
Chaque élément apparaît comme une icône de taille normale (32 x 32 pixels) avec une étiquette en dessous. L'utilisateur peut faire glisser les éléments à n'importe quel endroit dans la fenêtre d'affichage de liste.
Chaque élément apparaît comme une petite icône (16 x 16 pixels) avec l'étiquette à la droite de celui-ci. L'utilisateur peut faire glisser les éléments à n'importe quel endroit dans la fenêtre d'affichage de liste.
Chaque élément apparaît comme une petite icône avec une étiquette à la droite de celui-ci. Les éléments sont disposés en colonnes et ne peuvent être déplacés n'importe où dans la fenêtre d'affichage de liste.
Chaque élément apparaît sur sa propre ligne, avec des informations supplémentaires disposées en colonnes à droite. La colonne de gauche contient la petite icône et l'étiquette, les colonnes suivantes contiennent des sous-éléments comme spécifié par l'application. Un contrôle d'en-tête incorporé (classe CHeaderCtrl) implémente ces colonnes. Pour plus d'informations sur le contrôle de l'en-tête et les colonnes dans une vue de rapport, voir à l'aide de CListCtrl : ajout de colonnes au contrôle (voir rapport).
Le style d'affichage de liste actuel du contrôle détermine l'affichage actuel. Pour plus d'informations sur ces ces styles et leur utilisation, consultez à l'aide de CListCtrl : évolution des Styles de contrôle liste.
Styles étendus
En plus des styles de liste standard, classe CListCtrl prend en charge un grand nombre de styles étendus, offrant des fonctionnalités enrichies. Voici quelques exemples de cette fonctionnalité:
Lorsqu'il est activé, permet la sélection automatique d'un élément lorsque le curseur reste sur l'élément pour une certaine période de temps.
Lorsqu'il est activé, permet le contrôle à l'appui pour les éléments DWORD . Ceci est possible en plaçant les frais généraux de gestion des données sur l'application de l'élément. Sauf pour la sélection de l'élément et focus, toutes les informations de l'élément doivent être gérées par l'application. Pour plus d'informations, voir à l'aide de CListCtrl : les contrôles de liste virtuelle.
Lorsqu'il est activé, permet un suivi chaud (surlignage automatique du texte de l'élément) et cliquez sur one– ou two– l'activation de l'élément en surbrillance.
Lorsqu'il est activé, permet de glisser-déplacer, réorganisation des colonnes dans un contrôle list view. Disponible uniquement en mode rapport.
Pour plus d'informations sur l'utilisation de ces nouveaux extended styles, consultez à l'aide de CListCtrl : évolution des Styles de contrôle liste.
Éléments et sous-éléments
Chaque élément dans un contrôle list view se compose d'une icône (par une liste d'images), un label, un état actuel et une valeur définie par l'application (appelé « données »). Un ou plusieurs sous-éléments peuvent être également associée liés chaque élément. Un « point » est une chaîne qui, selon le rapport, peut être affichée dans une colonne à droite de l'icône et l'étiquette d'un élément. Tous les éléments dans un contrôle list view doivent avoir le même nombre de sous-éléments.
Classe CListCtrl fournit plusieurs fonctions d'insertion, suppression, trouver et modifier ces éléments. Pour plus d'informations, voir CListCtrl::GetItem, CListCtrl::InsertItemet CListCtrl::FindItem, CListCtrl en utilisant : ajout d'éléments au contrôle, et à l'aide de CListCtrl : défilement, arranger, le tri et trouver dans la liste des contrôles.
Par défaut, le contrôle list view est responsable pour le stockage des attributs de texte et icône un élément. Cependant, en plus de ces types d'éléments, classe CListCtrl soutient "objets de rappel". Un « élément de rappel » est un élément de la vue liste pour lesquels la demande — plutôt que le contrôle — stocke le texte, icône ou les deux. Un masque de rappel est utilisé pour spécifier les attributs de l'élément (texte ou icône) sont fournis par l'application. Si une application utilise des objets de rappel, il doit être capable de fournir les attributs de texte et icône sur demande. Articles de rappel sont utiles lorsque votre application déjà conserve certaines de ces informations. Pour plus d'informations, voir CListCtrl::GetCallBackMask et à l'aide de CListCtrl : articles de rappel et le masque de rappel.
Listes d'images
Les icônes et images d'élément d'en-tête application– défini les États d'affichage de la liste des éléments contenus dans plusieurs listes d'images (implémentées par la classe CImageList), que vous créez et assignez pour le contrôle list view. Chaque contrôle list view peut avoir jusqu'à quatre différents types de listes d'images:
Utilisé dans l'affichage de l'icône de la taille des icônes.
Utilisé dans la petite icône, liste et vues de rapport pour des versions plus petites des icônes utilisées dans l'affichage de l'icône.
Contient des images d'État sont affichées à côté de l'icône d'un élément pour indiquer un état défini par l'application.
Utilisée dans la vue de rapport pour les petites images qui apparaissent dans chaque point de contrôle d'en-tête.
Par défaut, un contrôle list view détruit les listes d'image attribués à elle lorsqu'elle est détruite ; Cependant, les développeurs peuvent personnaliser ce comportement en détruisant chaque liste d'images lorsqu'il est utilisé n'est plus, tel que déterminé par l'application. Pour plus d'informations, voir CListCtrl en utilisant : les éléments de liste et listes d'images et CListCtrl en utilisant : les éléments de liste et listes d'Image.
# include lt;afxcmn.h>
Membres de la classe | ; Classe de base | Graphique de la hiérarchie
Écha&ntillons denbsp ; Exemple MFC DAOTABLE | Exemple MFC HTTPSVR | MFC exemple LISTHDR | MFC exemple ROWLIST | Exemple MFC DBVLIST
Voir aussi ;CImageList