Partager via


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

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.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CListCtrl

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

CWnd, classe

Graphique de la hiérarchie

CImageList, classe

Concepts

exemple MFC ROWLIST