Classe de CListCtrl

Article
03/04/2013

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
CListCtrl::CListCtrl	Construit un objet CListCtrl.

Méthodes publiques

Nom	Description
CListCtrl::ApproximateViewRect	Détermine la largeur et la hauteur requise pour afficher les éléments d'un contrôle liste view.
CListCtrl::Arrange	Aligne les éléments sur une grille.
CListCtrl::CancelEditLabel	Annule l'opération d'édition de texte de l'élément.
CListCtrl::Create	Crée un contrôle de liste et l'attache à un objet d' CListCtrl .
CListCtrl::CreateDragImage	Crée une liste d'images pour faire glisser un élément spécifié.
CListCtrl::CreateEx	Crée un contrôle de liste avec les styles étendus par windows spécifiées et l'attache à un objet d' CListCtrl .
CListCtrl::DeleteAllItems	Supprime tous les éléments du contrôle.
CListCtrl::DeleteColumn	Supprime une colonne du contrôle liste view.
CListCtrl::DeleteItem	Supprime un élément du contrôle.
CListCtrl::DrawItem	Appelé lorsqu'un aspect visuel s'aligne d'un contrôle owner draw.
CListCtrl::EditLabel	Démarre la modification sur place du texte d'un élément.
CListCtrl::EnableGroupView	Active ou désactive si les éléments dans une vue Liste affichage en tant que groupe.
CListCtrl::EnsureVisible	Garantit qu'un élément est visible.
CListCtrl::FindItem	Recherche un élément de l'affichage de liste ayant spécifié des caractéristiques.
CListCtrl::GetBkColor	Extrait la couleur d'arrière-plan d'un contrôle liste view.
CListCtrl::GetBkImage	Récupère l'image d'arrière-plan actuelle d'un contrôle liste view.
CListCtrl::GetCallbackMask	Récupère le masque de rappel pour un contrôle liste view.
CListCtrl::GetCheck	Extrait l'état actuel d'affichage de l'image d'état associée à un élément.
CListCtrl::GetColumn	Récupère les attributs d'une colonne du contrôle.
CListCtrl::GetColumnOrderArray	Récupère l'ordre des colonnes (de gauche à droite) d'un contrôle liste view.
CListCtrl::GetColumnWidth	Extrait la largeur d'une colonne en mode Rapport ou la vue Liste.
CListCtrl::GetCountPerPage	Calcule le nombre d'éléments qui peuvent être intégrées verticalement dans un contrôle liste view.
CListCtrl::GetEditControl	Récupère le handle du contrôle d'édition utilisé pour modifier le texte d'un élément.
CListCtrl::GetEmptyText	Extrait la chaîne à afficher si le contrôle liste view actuel est vide.
CListCtrl::GetExtendedStyle	Récupère les styles étendus actuels d'un contrôle liste view.
CListCtrl::GetFirstSelectedItemPosition	Extrait la position du premier élément de l'affichage de liste sélectionné dans un contrôle liste view.
CListCtrl::GetFocusedGroup	Récupère le groupe qui a le focus clavier dans le contrôle liste view actuel.
CListCtrl::GetGroupCount	Récupère le nombre de groupes dans le contrôle liste view actuel.
CListCtrl::GetGroupInfo	Obtient les informations relatives à un groupe spécifié du contrôle liste view.
CListCtrl::GetGroupInfoByIndex	Récupère des informations sur un groupe spécifié dans le contrôle liste view actuel.
CListCtrl::GetGroupMetrics	Extrait la métrique d'un groupe.
CListCtrl::GetGroupRect	Récupère le rectangle englobant d'un groupe spécifié dans le contrôle liste view actuel.
CListCtrl::GetGroupState	Récupère l'état d'un groupe spécifié dans le contrôle liste view actuel.
CListCtrl::GetHeaderCtrl	Récupère le contrôle header d'un contrôle liste view.
CListCtrl::GetHotCursor	Récupère le curseur utilisé lorsque la sélection réactive est activée pour un contrôle liste view.
CListCtrl::GetHotItem	Récupère l'élément de l'affichage de liste actuelle sous le curseur.
CListCtrl::GetHoverTime	Extrait l'heure actuelle de pointage d'un contrôle liste view.
CListCtrl::GetImageList	Récupère le handle d'une liste d'images utilisée pour dessiner des éléments de l'affichage de liste.
CListCtrl::GetInsertMark	Extrait la position actuelle de la marque d'insertion.
CListCtrl::GetInsertMarkColor	Extrait la couleur actuelle de la marque d'insertion.
CListCtrl::GetInsertMarkRect	Récupère le rectangle limites que le point d'insertion.
CListCtrl::GetItem	Récupère les attributs d'un élément de l'affichage de liste.
CListCtrl::GetItemCount	Récupère le nombre d'éléments dans un contrôle liste view.
CListCtrl::GetItemData	Extrait la valeur spécifique à l'application associée à un élément.
CListCtrl::GetItemIndexRect	Récupère le rectangle englobant de l'ensemble ou une partie d'un sous-élément dans le contrôle liste view actuel.
CListCtrl::GetItemPosition	Extrait la position d'un élément de l'affichage de liste.
CListCtrl::GetItemRect	Récupère le rectangle englobant d'un élément.
CListCtrl::GetItemSpacing	Calcule l'espacement entre les éléments du contrôle liste view actuel.
CListCtrl::GetItemState	Récupère l'état d'un élément de l'affichage de liste.
CListCtrl::GetItemText	Extrait le texte d'un élément de l'affichage de liste ou d'un sous-élément.
CListCtrl::GetNextItem	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é.
CListCtrl::GetNextItemIndex	Extrait l'index de l'élément du contrôle liste view actuel qui a un jeu spécifié de propriétés.
CListCtrl::GetNextSelectedItem	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.
CListCtrl::GetNumberOfWorkAreas	Récupère le nombre actuel d'emplacements de travail pour un contrôle liste view.
CListCtrl::GetOrigin	Récupère l'origine de l'affichage actuel pour un contrôle liste view.
CListCtrl::GetOutlineColor	Extrait la couleur de la bordure d'un contrôle liste view.
CListCtrl::GetSelectedColumn	Extrait l'index de la colonne sélectionnée dans le contrôle de liste.
CListCtrl::GetSelectedCount	Récupère le nombre d'éléments sélectionnés dans le contrôle liste view.
CListCtrl::GetSelectionMark	Récupère le jeton de sélection d'un contrôle liste view.
CListCtrl::GetStringWidth	Détermine la largeur de colonne minimale requise pour afficher toute la chaîne donnée.
CListCtrl::GetSubItemRect	Récupère le rectangle englobant d'un élément dans un contrôle liste view.
CListCtrl::GetTextBkColor	Extrait la couleur d'arrière-plan du texte d'un contrôle liste view.
CListCtrl::GetTextColor	Extrait la couleur du texte d'un contrôle liste view.
CListCtrl::GetTileInfo	Récupère des informations sur une mosaïque dans un contrôle liste view.
CListCtrl::GetTileViewInfo	Récupère des informations sur un contrôle liste view dans l'affichage en mosaïque.
CListCtrl::GetToolTips	Récupère le contrôle d'info-bulle que le contrôle liste view utilise pour afficher des info-bulles.
CListCtrl::GetTopIndex	Extrait l'index de l'élément visible le plus élevé.
CListCtrl::GetView	Obtient la vue du contrôle liste view.
CListCtrl::GetViewRect	Récupère le rectangle englobant de tous les éléments du contrôle liste view.
CListCtrl::GetWorkAreas	Récupère les emplacements de travail actuels d'un contrôle liste view.
CListCtrl::HasGroup	Détermine si le contrôle liste view a le groupe spécifié.
CListCtrl::HitTest	Détermine quel élément de l'affichage de liste est à une position spécifiée.
CListCtrl::InsertColumn	Insère une nouvelle colonne dans un contrôle liste view.
CListCtrl::InsertGroup	Insère un groupe dans le contrôle liste view.
CListCtrl::InsertGroupSorted	Insère le groupe spécifié dans une liste triée de groupes.
CListCtrl::InsertItem	Insère un nouvel élément dans un contrôle liste view.
CListCtrl::InsertMarkHitTest	Récupère le point d'insertion le plus proche d'un point spécifié.
CListCtrl::IsGroupViewEnabled	Détermine si la vue de groupe est activée pour un contrôle liste view.
CListCtrl::IsItemVisible	Indique si un élément spécifié dans le contrôle liste view actuellement visible.
CListCtrl::MapIDToIndex	Mappe l'identificateur unique d'un élément du contrôle liste view actuel à un index.
CListCtrl::MapIndexToID	Mappe l'index d'un élément du contrôle liste view actuel à un ID
CListCtrl::MoveGroup	Déplace le groupe spécifié.
CListCtrl::MoveItemToGroup	Déplace le groupe spécifié à l'index spécifié de base zéro du contrôle liste view.
CListCtrl::RedrawItems	Force un contrôle liste view pour redessiner une plage d'éléments.
CListCtrl::RemoveAllGroups	Supprime tous les groupes d'un contrôle liste view.
CListCtrl::RemoveGroup	Supprime le groupe spécifié du contrôle liste view.
CListCtrl::Scroll	Fait défiler le contenu d'un contrôle liste view.
CListCtrl::SetBkColor	Définit la couleur d'arrière-plan du contrôle liste view.
CListCtrl::SetBkImage	Définit l'image d'arrière-plan actuelle d'un contrôle liste view.
CListCtrl::SetCallbackMask	Définit le masque de rappel pour un contrôle liste view.
CListCtrl::SetCheck	Définit l'état actuel d'affichage de l'image d'état associée à un élément.
CListCtrl::SetColumn	Définit les attributs d'une colonne de vue Liste.
CListCtrl::SetColumnOrderArray	Définit l'ordre des colonnes (de gauche à droite) d'un contrôle liste view.
CListCtrl::SetColumnWidth	Modifie la largeur d'une colonne en mode Rapport ou la vue Liste.
CListCtrl::SetExtendedStyle	Définit les styles étendus actuels d'un contrôle liste view.
CListCtrl::SetGroupInfo	Définit les informations du groupe spécifié d'un contrôle liste view.
CListCtrl::SetGroupMetrics	Définit la métrique du groupe d'un contrôle liste view.
CListCtrl::SetHotCursor	Place le curseur utilisé lorsque la sélection réactive est activée pour un contrôle liste view.
CListCtrl::SetHotItem	Définit l'élément réactif actuel d'un contrôle liste view.
CListCtrl::SetHoverTime	Définit l'heure actuelle de pointage d'un contrôle liste view.
CListCtrl::SetIconSpacing	Définit l'espacement entre les icônes dans un contrôle liste view.
CListCtrl::SetImageList	Assigne une liste d'images à un contrôle liste view.
CListCtrl::SetInfoTip	Définit le texte d'info-bulle.
CListCtrl::SetInsertMark	Définit le point d'insertion à la position définie.
CListCtrl::SetInsertMarkColor	Définit la couleur du point d'insertion.
CListCtrl::SetItem	Définit une partie ou l'ensemble des attributs d'un élément de l'affichage de liste.
CListCtrl::SetItemCount	Prépare un contrôle liste view pour ajouter un grand nombre d'éléments.
CListCtrl::SetItemCountEx	Définit le nombre d'éléments pour un contrôle liste view virtuel.
CListCtrl::SetItemData	Définit la valeur spécifique à l'application de l'élément.
CListCtrl::SetItemIndexState	Définit l'état d'un élément du contrôle liste view actuel.
CListCtrl::SetItemPosition	Déplace un élément à une position spécifiée dans un contrôle liste view.
CListCtrl::SetItemState	Change l'état d'un élément dans un contrôle liste view.
CListCtrl::SetItemText	Modifie le texte d'un élément de l'affichage de liste ou d'un sous-élément.
CListCtrl::SetOutlineColor	Définit la couleur de la bordure d'un contrôle liste view.
CListCtrl::SetSelectedColumn	Définit la colonne sélectionnée du contrôle liste view.
CListCtrl::SetSelectionMark	Définit le jeton de sélection d'un contrôle liste view.
CListCtrl::SetTextBkColor	Définit la couleur d'arrière-plan du texte dans un contrôle liste view.
CListCtrl::SetTextColor	Définit la couleur du texte d'un contrôle liste view.
CListCtrl::SetTileInfo	Définit les informations pour une mosaïque du contrôle liste view.
CListCtrl::SetTileViewInfo	Définit les informations qu'un contrôle liste view utilise dans l'affichage en mosaïque.
CListCtrl::SetToolTips	Définit le contrôle d'info-bulle que le contrôle liste view utilisera pour afficher des info-bulles.
CListCtrl::SetView	Définit la vue du contrôle liste view.
CListCtrl::SetWorkAreas	Définit la zone où les icônes peuvent être affichées dans un contrôle liste view.
CListCtrl::SortGroups	Trie les groupes d'un contrôle liste view avec une fonction définie par l'utilisateur.
CListCtrl::SortItems	Trie les éléments d'affichage de liste à l'aide d'une fonction de comparaison définie par l'application.
CListCtrl::SortItemsEx	Trie les éléments d'affichage de liste à l'aide d'une fonction de comparaison définie par l'application.
CListCtrl::SubItemHitTest	Détermine que l'élément de l'affichage de liste, le cas échéant, est à une position donnée.
CListCtrl::Update	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.