Partager via

Vue d’ensemble du contrôle ListView (Windows Forms)

Le contrôle ListView Windows Forms affiche une liste d’éléments avec des icônes. Vous pouvez utiliser un affichage de liste pour créer une interface utilisateur comme le volet droit de l’Explorateur Windows. Le contrôle a quatre modes d’affichage : LargeIcon, SmallIcon, List et Details.

Ce que vous pouvez faire avec le contrôle ListView

Remarque

Un mode d’affichage supplémentaire, vignette, est disponible uniquement sur Windows XP et le système d’exploitation Windows Server 2003. Pour plus d’informations, consultez Comment : Activer l'affichage par vignettes dans un contrôle ListView de Windows Forms.

Le mode LargeIcon affiche des icônes volumineuses en regard du texte de l’élément ; les éléments apparaissent dans plusieurs colonnes si le contrôle est suffisamment grand. Le mode SmallIcon est le même, sauf qu’il affiche de petites icônes. Le mode Liste affiche de petites icônes, mais se trouve toujours dans une seule colonne. Le mode Détails affiche les éléments dans plusieurs colonnes. Pour plus d’informations, consultez Comment ajouter des colonnes au contrôle ListView de Windows Forms. Le mode d’affichage est déterminé par la propriété View. Tous les modes d’affichage peuvent afficher des images à partir de listes d’images. Pour plus d’informations, consultez Guide pratique pour afficher des icônes pour le contrôle ListView Windows Forms.

Le tableau suivant répertorie certains des membres ListView et les vues dans lesquelles ils sont valides.

Membre ListView Afficher
Propriété Alignment SmallIcon ou LargeIcon
Propriété AutoArrange SmallIcon ou LargeIcon
méthode AutoResizeColumn Details
Propriété Columns Details ou Tile
DrawSubItem événement Details
méthode FindItemWithText Details, List ou Tile
méthode FindNearestItem SmallIcon ou LargeIcon
méthode GetItemAt Details ou Tile
Propriété Groups Toutes les vues, sauf List
Propriété HeaderStyle Details.
Propriété InsertionMark LargeIcon, SmallIcon ou Tile

La propriété clé du contrôle ListView est Items, qui contient les éléments affichés par le contrôle. La propriété SelectedItems contient une collection des éléments actuellement sélectionnés dans le contrôle. L’utilisateur peut sélectionner plusieurs éléments, par exemple pour faire glisser-déplacer plusieurs éléments à la fois vers un autre contrôle, si la propriété MultiSelect est définie sur true. Le contrôle ListView peut afficher des cases à cocher en regard des éléments, si la propriété CheckBoxes est définie sur true.

La propriété Activation détermine le type d’action que l’utilisateur doit entreprendre pour activer un élément dans la liste : les options sont Standard, OneClicket TwoClick. OneClick nécessite un seul clic pour être activé. TwoClick activation nécessite que l’utilisateur double-clique pour activer l’élément ; un seul clic modifie la couleur du texte de l’élément. Standard : l'activation nécessite que l’utilisateur double-clique pour activer un élément, mais l’élément ne change pas d’apparence.

Le contrôle ListView prend également en charge les styles visuels et d’autres fonctionnalités disponibles sur la plateforme Windows XP, notamment le regroupement, la vue de vignette et les marques d’insertion.

Voir aussi