CListCtrl, classe
Encapsule les fonctionnalités d'un contrôle liste view « , » qui affiche une collection d'éléments chacune qui se compose d'une icône (d'une liste d'images) et d'une étiquette.
class CListCtrl : public CWnd
Membres
Constructeurs publics
Nom |
Description |
---|---|
Construit un objet CListCtrl. |
Méthodes publiques
Nom |
Description |
---|---|
Détermine la largeur et la hauteur requise pour afficher les éléments d'un contrôle liste view. |
|
Aligne les éléments sur une grille. |
|
Annule l'opération d'édition de texte de l'élément. |
|
Crée un contrôle de liste et l'attache à un objet d' CListCtrl . |
|
Crée une liste d'images pour faire glisser un élément spécifié. |
|
Crée un contrôle de liste avec les styles étendus par windows spécifiées et l'attache à un objet d' CListCtrl . |
|
Supprime tous les éléments du contrôle. |
|
Supprime une colonne du contrôle liste view. |
|
Supprime un élément du contrôle. |
|
Appelé lorsqu'un aspect visuel s'aligne d'un contrôle owner draw. |
|
Démarre la modification sur place du texte d'un élément. |
|
Active ou désactive si les éléments dans une vue Liste affichage en tant que groupe. |
|
Garantit qu'un élément est visible. |
|
Recherche un élément de l'affichage de liste ayant spécifié des caractéristiques. |
|
Extrait la couleur d'arrière-plan d'un contrôle liste view. |
|
Récupère l'image d'arrière-plan actuelle d'un contrôle liste view. |
|
Récupère le masque de rappel pour un contrôle liste view. |
|
Extrait l'état actuel d'affichage de l'image d'état associée à un élément. |
|
Récupère les attributs d'une colonne du contrôle. |
|
Récupère l'ordre des colonnes (de gauche à droite) d'un contrôle liste view. |
|
Extrait la largeur d'une colonne en mode Rapport ou la vue Liste. |
|
Calcule le nombre d'éléments qui peuvent être intégrées verticalement dans un contrôle liste view. |
|
Récupère le handle du contrôle d'édition utilisé pour modifier le texte d'un élément. |
|
Extrait la chaîne à afficher si le contrôle liste view actuel est vide. |
|
Récupère les styles étendus actuels d'un contrôle liste view. |
|
Extrait la position du premier élément de l'affichage de liste sélectionné dans un contrôle liste view. |
|
Récupère le groupe qui a le focus clavier dans le contrôle liste view actuel. |
|
Récupère le nombre de groupes dans le contrôle liste view actuel. |
|
Obtient les informations relatives à un groupe spécifié du contrôle liste view. |
|
Récupère des informations sur un groupe spécifié dans le contrôle liste view actuel. |
|
Extrait la métrique d'un groupe. |
|
Récupère le rectangle englobant d'un groupe spécifié dans le contrôle liste view actuel. |
|
Récupère l'état d'un groupe spécifié dans le contrôle liste view actuel. |
|
Récupère le contrôle header d'un contrôle liste view. |
|
Récupère le curseur utilisé lorsque la sélection réactive est activée pour un contrôle liste view. |
|
Récupère l'élément de l'affichage de liste actuelle sous le curseur. |
|
Extrait l'heure actuelle de pointage d'un contrôle liste view. |
|
Récupère le handle d'une liste d'images utilisée pour dessiner des éléments de l'affichage de liste. |
|
Extrait la position actuelle de la marque d'insertion. |
|
Extrait la couleur actuelle de la marque d'insertion. |
|
Récupère le rectangle limites que le point d'insertion. |
|
Récupère les attributs d'un élément de l'affichage de liste. |
|
Récupère le nombre d'éléments dans un contrôle liste view. |
|
Extrait la valeur spécifique à l'application associée à un élément. |
|
Récupère le rectangle englobant de l'ensemble ou une partie d'un sous-élément dans le contrôle liste view actuel. |
|
Extrait la position d'un élément de l'affichage de liste. |
|
Récupère le rectangle englobant d'un élément. |
|
Calcule l'espacement entre les éléments du contrôle liste view actuel. |
|
Récupère l'état d'un élément de l'affichage de liste. |
|
Extrait le texte d'un élément de l'affichage de liste ou d'un sous-élément. |
|
Recherche un élément de l'affichage de liste avec les propriétés spécifiées et avec la relation spécifiée à un élément donné. |
|
Extrait l'index de l'élément du contrôle liste view actuel qui a un jeu spécifié de propriétés. |
|
Récupère l'index d'une position d'élément de l'affichage de liste, et la position de l'élément de l'affichage de liste sélectionné pour itérer. |
|
Récupère le nombre actuel d'emplacements de travail pour un contrôle liste view. |
|
Récupère l'origine de l'affichage actuel pour un contrôle liste view. |
|
Extrait la couleur de la bordure d'un contrôle liste view. |
|
Extrait l'index de la colonne sélectionnée dans le contrôle de liste. |
|
Récupère le nombre d'éléments sélectionnés dans le contrôle liste view. |
|
Récupère le jeton de sélection d'un contrôle liste view. |
|
Détermine la largeur de colonne minimale requise pour afficher toute la chaîne donnée. |
|
Récupère le rectangle englobant d'un élément dans un contrôle liste view. |
|
Extrait la couleur d'arrière-plan du texte d'un contrôle liste view. |
|
Extrait la couleur du texte d'un contrôle liste view. |
|
Récupère des informations sur une mosaïque dans un contrôle liste view. |
|
Récupère des informations sur un contrôle liste view dans l'affichage en mosaïque. |
|
Récupère le contrôle d'info-bulle que le contrôle liste view utilise pour afficher des info-bulles. |
|
Extrait l'index de l'élément visible le plus élevé. |
|
Obtient la vue du contrôle liste view. |
|
Récupère le rectangle englobant de tous les éléments du contrôle liste view. |
|
Récupère les emplacements de travail actuels d'un contrôle liste view. |
|
Détermine si le contrôle liste view a le groupe spécifié. |
|
Détermine quel élément de l'affichage de liste est à une position spécifiée. |
|
Insère une nouvelle colonne dans un contrôle liste view. |
|
Insère un groupe dans le contrôle liste view. |
|
Insère le groupe spécifié dans une liste triée de groupes. |
|
Insère un nouvel élément dans un contrôle liste view. |
|
Récupère le point d'insertion le plus proche d'un point spécifié. |
|
Détermine si la vue de groupe est activée pour un contrôle liste view. |
|
Indique si un élément spécifié dans le contrôle liste view actuellement visible. |
|
Mappe l'identificateur unique d'un élément du contrôle liste view actuel à un index. |
|
Mappe l'index d'un élément du contrôle liste view actuel à un ID |
|
Déplace le groupe spécifié. |
|
Déplace le groupe spécifié à l'index spécifié de base zéro du contrôle liste view. |
|
Force un contrôle liste view pour redessiner une plage d'éléments. |
|
Supprime tous les groupes d'un contrôle liste view. |
|
Supprime le groupe spécifié du contrôle liste view. |
|
Fait défiler le contenu d'un contrôle liste view. |
|
Définit la couleur d'arrière-plan du contrôle liste view. |
|
Définit l'image d'arrière-plan actuelle d'un contrôle liste view. |
|
Définit le masque de rappel pour un contrôle liste view. |
|
Définit l'état actuel d'affichage de l'image d'état associée à un élément. |
|
Définit les attributs d'une colonne de vue Liste. |
|
Définit l'ordre des colonnes (de gauche à droite) d'un contrôle liste view. |
|
Modifie la largeur d'une colonne en mode Rapport ou la vue Liste. |
|
Définit les styles étendus actuels d'un contrôle liste view. |
|
Définit les informations du groupe spécifié d'un contrôle liste view. |
|
Définit la métrique du groupe d'un contrôle liste view. |
|
Place le curseur utilisé lorsque la sélection réactive est activée pour un contrôle liste view. |
|
Définit l'élément réactif actuel d'un contrôle liste view. |
|
Définit l'heure actuelle de pointage d'un contrôle liste view. |
|
Définit l'espacement entre les icônes dans un contrôle liste view. |
|
Assigne une liste d'images à un contrôle liste view. |
|
Définit le texte d'info-bulle. |
|
Définit le point d'insertion à la position définie. |
|
Définit la couleur du point d'insertion. |
|
Définit une partie ou l'ensemble des attributs d'un élément de l'affichage de liste. |
|
Prépare un contrôle liste view pour ajouter un grand nombre d'éléments. |
|
Définit le nombre d'éléments pour un contrôle liste view virtuel. |
|
Définit la valeur spécifique à l'application de l'élément. |
|
Définit l'état d'un élément du contrôle liste view actuel. |
|
Déplace un élément à une position spécifiée dans un contrôle liste view. |
|
Change l'état d'un élément dans un contrôle liste view. |
|
Modifie le texte d'un élément de l'affichage de liste ou d'un sous-élément. |
|
Définit la couleur de la bordure d'un contrôle liste view. |
|
Définit la colonne sélectionnée du contrôle liste view. |
|
Définit le jeton de sélection d'un contrôle liste view. |
|
Définit la couleur d'arrière-plan du texte dans un contrôle liste view. |
|
Définit la couleur du texte d'un contrôle liste view. |
|
Définit les informations pour une mosaïque du contrôle liste view. |
|
Définit les informations qu'un contrôle liste view utilise dans l'affichage en mosaïque. |
|
Définit le contrôle d'info-bulle que le contrôle liste view utilisera pour afficher des info-bulles. |
|
Définit la vue du contrôle liste view. |
|
Définit la zone où les icônes peuvent être affichées dans un contrôle liste view. |
|
Trie les groupes d'un contrôle liste view avec une fonction définie par l'utilisateur. |
|
Trie les éléments d'affichage de liste à l'aide d'une fonction de comparaison définie par l'application. |
|
Trie les éléments d'affichage de liste à l'aide d'une fonction de comparaison définie par l'application. |
|
Détermine que l'élément de l'affichage de liste, le cas échéant, est à une position donnée. |
|
Force le contrôle pour redessiner un élément spécifié. |
Notes
En plus d'une icône et une étiquette, chaque élément peut contenir les informations affichées dans les colonnes à droite de l'icône et de l'étiquette. Ce contrôle (et par conséquent la classe d' CListCtrl ) est disponible uniquement aux programmes s'exécutant sous la version 3,51 de Windows 95/98 et Windows NT et versions ultérieures.
Voici une vue d'ensemble de la classe d' CListCtrl . Pour une description détaillée et conceptuelle, consultez Utilisation CListCtrl et le contrôles.
Vues
Les contrôles liste view peuvent afficher leur contenu de quatre manières différentes, appelées « vues. »
Vue icône
Chaque élément apparaît en pixels de l'icône de taille normale (32 x 32) avec une étiquette au-dessous de lui. L'utilisateur peut faire glisser les éléments à tout emplacement dans la fenêtre vue Liste.
Vue de petite icône
Chaque élément apparaît en pixels de la petite icône (16 x 16) avec l'étiquette située à droite de lui. L'utilisateur peut faire glisser les éléments à tout emplacement dans la fenêtre vue Liste.
Vue Liste
Chaque élément apparaît comme une petite icône à une étiquette à droite de lui. Les éléments sont disposés dans les colonnes et ne peuvent pas être glissés vers n'importe où dans la fenêtre vue Liste.
Mode Rapport
Chaque élément apparaît sur sa propre ligne, avec les informations supplémentaires réorganisées dans les colonnes à droite. La colonne la plus à gauche contient la petite icône et l'étiquette, et les colonnes suivantes contiennent des sous-éléments comme spécifié par l'application. Un contrôle header incorporés (classe) CHeaderCtrlimplémente ces colonnes. Pour plus d'informations sur le contrôle header et les colonnes dans un mode Rapport, consultez l' Utilisation CListCtrl : Ajout de colonnes au contrôle (mode Rapport).
Voir aussi :
Article de la Base de connaissances Q250614 : HOWTO : Éléments de tri dans un CListCtrl en mode Rapport
Article de la Base de connaissances Q200054 : PRB : OnTimer() n'est pas appelée à plusieurs reprises pour un contrôle de liste
Le style de la vue Liste actuelle du contrôle détermine l'affichage actuel. Pour plus d'informations sur ces styles et leur utilisation, consultez l' Utilisation CListCtrl : Modification des styles de contrôle liste.
Styles étendus
Outre les styles standard de liste, classez CListCtrl prend en charge un grand ensemble de styles étendus, en fournissant les fonctionnalités enrichie. Quelques exemples de ces fonctionnalités incluent :
Sélection de pointage
Une fois activé, autorise la sélection automatique d'un élément lorsque le curseur reste sur l'élément pendant un certain temps.
Vues Liste virtuelles
Une fois activé, permet au contrôle prenne en charge jusqu'à DWORD des éléments. Ceci est possible en définissant la charge mémoire de gérer des données d'élément dans l'application. À l'exception de la sélection d'élément et de focus, toutes les informations d'élément doivent être gérées par l'application. Pour plus d'informations, consultez l' Utilisation CListCtrl : contrôles de liste virtuels.
Activation d'un et deux clics
Une fois activé, autorise la sélection réactive (mettre en surbrillance automatique du texte de l'élément) et le lancement d'un ou deux clics de l'élément en surbrillance.
Le classement de la colonne de glisser-déplacer
Une fois activé, permet de réorganiser glisser-déplacer des colonnes dans un contrôle liste view. Disponible uniquement en mode Rapport.
Pour plus d'informations sur l'utilisation de ces nouveaux styles étendus, consultez l' Utilisation CListCtrl : Modification des styles de contrôle liste.
Éléments et sous-éléments
Chaque élément dans un contrôle liste view se compose d'une icône (d'une liste d'images), d'une étiquette, d'un état actuel, et une valeur définie par l'application (appelée sous le nom de « données d'élément »). Un ou plusieurs des sous-éléments peuvent également être associés à chaque élément. Un « sous-élément » est une chaîne qui, en mode Rapport, peut être affichée dans une colonne à droite de l'icône et de l'étiquette d'un élément. Tous les éléments dans un contrôle liste view doivent avoir le même nombre de sous-éléments.
La classe CListCtrl fournit plusieurs fonctions pour insérer, supprimer, rechercher, et modifier ces éléments. Pour plus d'informations, consultez CListCtrl::GetItem, CListCtrl::InsertItem, et CListCtrl::FindItem, Utilisation CListCtrl : ajouter des éléments au contrôle, et Utilisation CListCtrl : Défilement, réorganiser, trier, et rechercher dans les contrôles de liste.
Par défaut, le contrôle liste view est chargé d'enregistrer l'icône et les attributs du texte d'un élément. Toutefois, en plus de ces types d'éléments, la classe CListCtrl « prend en charge les éléments de rappel. » « Un élément de rappel » est un élément de l'affichage de liste pour lequel l'application (plutôt que le contrôle — les magasins le texte, l'icône, ou les deux. Un masque de rappel est utilisé pour spécifier les attributs de l'élément (texte et/ou icône) sont fournies par l'application. Si une application utilise des éléments de rappel, il doit pouvoir fournir du texte et/ou l'icône l'attribut à la demande. Les éléments de rappel sont utiles lorsque votre application met à jour déjà certaines de ces informations. Pour plus d'informations, consultez l' Utilisation CListCtrl : éléments de rappel et le masque de rappel.
Listes d'images
Les icônes, les images d'élément d'en-tête, et les rapports définis par l'application pour les éléments de l'affichage de liste sont contenus dans plusieurs listes d'images (implémentées par la classe CImageList), que vous créez et assignez au contrôle liste view. Chaque contrôle liste view peut contenir jusqu'à quatre types de listes d'images :
Grande icône
Utilisé dans la vue icône pour les icônes de taille normale.
Petite icône
Utilisé dans la petite icône, la liste, et les vues de Rapport pour les petites versions des icônes utilisées dans la vue icône.
État défini par l'application
Contient les images d'état, qui sont affichées en regard de l'icône d'un élément pour indiquer un état défini par l'application.
Header Item
Utilisé en mode Rapport pour les petites icônes qui apparaissent dans chaque élément de contrôle header.
Par défaut, un contrôle liste view détruit les listes d'images assignées à lui lorsqu'il est détruit ; toutefois, le développeur peut personnaliser ce comportement en détruisant chaque liste d'images lorsqu'il n'est plus utilisé, tel que déterminé par l'application. Pour plus d'informations, consultez l' Utilisation CListCtrl : éléments de liste et listes d'images.
Hiérarchie d'héritage
CListCtrl
Configuration requise
Header: afxcmn.h