Partager via


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

Mise à jour : novembre 2007

Le contrôle ListView Windows Forms affiche une liste d'éléments avec des icônes. Vous pouvez l'utiliser pour créer une interface semblable au volet droit de l'Explorateur Windows. Ce contrôle possède 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, Mosaïque, est uniquement disponible sur Windows XP et le système d'exploitation Windows Server 2003. Pour plus d'informations, consultez Comment : activer l'affichage en mosaïque dans un contrôle ListView Windows Forms.

Le mode LargeIcon affiche de grandes icônes en regard du texte de l'élément ; les éléments sont disposés sur plusieurs colonnes si la taille du contrôle le permet. Le mode SmallIcon est identique au précédent, mais les icônes affichées sont plus petites. Le mode List affiche des petites icônes, mais toujours sur 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 Windows Forms. Le mode d'affichage est déterminé par la propriété View. Tous les modes peuvent afficher des images issues de listes d'images. Pour plus d'informations, consultez Comment : afficher des icônes pour le contrôle ListView Windows Forms.

Le tableau suivant répertorie quelques-uns des membres ListView et les affichages dans lesquels ils sont valides.

Membre ListView

Affichage

Propriété Alignment

SmallIcon ou LargeIcon

Propriété AutoArrange

SmallIcon ou LargeIcon

Méthode AutoResizeColumn

Details

Propriété Columns

Details ou Tile

Événement DrawSubItem

Details

Méthode FindItemWithText

Details, List ou Tile

Méthode FindNearestItem

SmallIcon ou LargeIcon

Méthode GetItemAt

Details ou Tile

Propriété Groups

Tous les affichages sauf List

Propriété HeaderStyle

Details.

Propriété InsertionMark

LargeIcon, SmallIcon ou Tile

La principale propriété 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. Si la propriété MultiSelect a la valeur true, l'utilisateur peut sélectionner plusieurs éléments, par exemple pour effectuer une opération glisser-déplacer de plusieurs éléments simultanément vers un autre contrôle. Le contrôle ListView peut afficher des cases à cocher à côté des éléments si la propriété CheckBoxes a la valeur true.

La propriété Activation détermine le type d'action à exécuter par l'utilisateur pour activer un élément dans la liste : les options sont Standard, OneClick et TwoClick. L'activation de OneClick requiert un simple clic pour activer l'élément. L'activation de TwoClick requiert un double-clic pour activer l'élément et un simple clic modifie la couleur du texte de l'élément. L'activation de Standard requiert un double-clic pour activer un élément, mais l'aspect de l'élément n'est pas modifié.

Le contrôle ListView prend également en charge les styles visuels et les autres fonctionnalités disponibles sur la plateforme Windows XP (regroupement, affichage en mosaïque et marques d'insertion). Pour plus d'informations, consultez Fonctionnalités de Windows XP et contrôles Windows Forms.

Voir aussi

Tâches

Comment : ajouter et supprimer des éléments avec le contrôle ListView Windows Forms

Comment : ajouter des colonnes au contrôle ListView Windows Forms

Comment : afficher des icônes pour le contrôle ListView Windows Forms

Comment : afficher des sous-éléments en colonnes avec le contrôle ListView Windows Forms

Comment : sélectionner un élément dans le contrôle ListView Windows Forms

Comment : grouper des éléments dans un contrôle ListView Windows Forms

Comment : afficher une marque d'insertion dans un contrôle ListView Windows Forms

Comment : ajouter des fonctions de recherche à un contrôle ListView

Comment : ajouter des informations personnalisées à un contrôle TreeView ou ListView (Windows Forms)

Comment : créer une interface utilisateur à plusieurs volets à l'aide des Windows Forms

Référence

ListView

Autres ressources

ListView, contrôle (Windows Forms)