Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ListView.View propriété

 

Date de publication : novembre 2016

Obtient ou définit la façon d'afficher les éléments dans le contrôle.

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

public View View { get; set; }

Valeur de propriété

Type: System.Windows.Forms.View

Une des valeurs de View. La valeur par défaut est LargeIcon.

Exception Condition
InvalidEnumArgumentException

La valeur spécifiée ne fait pas partie de la View valeurs.

Le View propriété permet de spécifier le type d’affichage de la ListView contrôle utilise pour afficher les éléments. Vous pouvez définir le View propriété à afficher chaque élément sous forme de petites ou grandes icônes ou afficher des éléments dans une liste verticale. L’option la plus complète est la vue Détails, qui vous permet d’afficher non seulement les éléments, mais les sous-éléments spécifiés pour chaque élément. Chaque élément est affiché dans une grille, avec chaque élément répertorié verticalement et des sous-éléments pour chaque élément affiché dans une colonne, avec des en-têtes de colonne. L’affichage des détails est une façon idéale pour afficher des informations de base de données à un utilisateur. Avec Windows XP et Windows Server 2003, vous pouvez également afficher les éléments sous forme de mosaïques qui équilibrent les informations graphiques et textuelles en affichant une grande icône, ainsi que des informations de sous-élément de votre choix. Pour activer l’affichage en mosaïque, votre application doit appeler la Application.EnableVisualStyles méthode. L’affichage de petites images affiche chaque élément avec une icône et les informations textuelles à droite de l’icône. La grande image affiche chaque élément avec une icône et les informations textuelles sous l’icône. La taille des icônes pour la liste d’images est spécifiée par le ImageSize propriété de la ImageList pour le SmallImageList ou LargeImageList Propriétés.

System_CAPS_noteRemarque

Si vous utilisez plusieurs listes d’images pour l’affichage de petites et grandes icônes, avec un ListView (contrôle), vous devez placer les petites et grandes versions de l’image à la même position d’index dans leurs listes d’images respectives. Lors du basculement entre les vues, l’emplacement d’index de l’image dans une liste est utilisé pour localiser l’image dans la liste, quelle que soit la valeur de clé spécifiée.

La plupart des propriétés de la ListView contrôle affectent les différentes vues le comportement et sont affichent. Certaines propriétés qui affectent les vues des éléments ne sont utiles que lorsque la View est définie sur une valeur spécifique, tandis que d’autres sont utiles dans toutes les vues. Par exemple, les propriétés, telles que GridLines et FullRowSelect sont utiles uniquement lorsque la View est définie sur View.Details, tandis que le MultiSelect et CheckBoxes propriétés sont utiles dans toutes les vues.

Le tableau suivant présente certaines des ListView membres et les vues qu’ils sont valides dans.

Membre de ListView

Afficher

Propriété Alignment

SmallIcon ou LargeIcon

Propriété AutoArrange

SmallIcon ou LargeIcon

Méthode AutoResizeColumn

Details

CheckBoxes

Toutes les vues à l’exception Tile

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 à l’exception List

Propriété HeaderStyle

Details

Propriété InsertionMark

LargeIcon, SmallIcon ou Tile

Vous pouvez utiliser le View propriété pour fournir des vues différentes des données dans votre application, ou de verrouiller une vue spécifique pour utiliser pleinement ses avantages. Par exemple, le View est souvent définie sur View.Details car la vue Détails offre un nombre d’options non disponibles dans les autres modes d’affichage.

System_CAPS_noteRemarque

Si votre ListView contrôle n’a pas de tous les en-têtes de colonne spécifiés et que vous définissez le View propriété View.Details, la ListView contrôle n’affiche pas tous les éléments. Si votre ListView contrôle n’a pas de tous les en-têtes de colonne spécifiés et que vous définissez le View propriété View.Tile, la ListView contrôle n’affiche pas les sous-éléments.

L’affichage en mosaïque affiche chaque élément avec une grande icône sur les informations textuelles et de gauche à droite. Les informations textuelles se composent de l’étiquette d’élément suivie des sous-éléments. Par défaut, seul le premier sous-élément s’affiche, ce qui correspond à l’étiquette de l’élément. Pour afficher d’autres sous-éléments, vous devez ajouter ColumnHeader des objets dans le Columns collection. Chaque sous-élément dans la mosaïque correspond à un en-tête de colonne. Pour contrôler les sous-éléments affichés et l’ordre dans lequel ils sont affichés, vous devez définir le ListViewItem.ListViewSubItem.Name propriété pour chaque élément et le ColumnHeader.Name propriété pour chaque en-tête. Vous pouvez ensuite ajouter, supprimer et réorganiser les en-têtes de la Columns collection pour obtenir le résultat souhaité.

Pour contrôler la taille des mosaïques en mode mosaïque, définissez la TileSize propriété. Cela est utile pour empêcher le retour à la ligne lorsque le texte de sous-élément est trop long pour une seule ligne.

Pour obtenir un exemple de l’affichage en mosaïque, consultez le TileSize propriété.

System_CAPS_noteRemarque

Bien que les colonnes soient affichées uniquement en mode Détails, les sous-éléments sans en-têtes de colonne ne s’affichent pas dans la vue Détails ou l’affichage en mosaïque.

L’affichage en mosaïque est uniquement disponible sur Windows XP et Windows Server 2003 lorsque votre application appelle la Application.EnableVisualStyles méthode. Sur les systèmes d'exploitation antérieurs, tout code lié à l'affichage en mosaïque n'a aucun effet et le contrôle ListView s'affiche en mode Grandes icônes. Par conséquent, tout code qui dépend de l’affichage en mosaïque peuvent ne pas fonctionne correctement.

Vous pouvez inclure le code qui détermine si l’affichage en mosaïque est disponible et fournir d’autres fonctionnalités lorsqu’il n’est pas disponible. Par exemple, lorsque vous utilisez owner-drawn pour personnaliser l’apparence de ListView les éléments dans l’affichage en mosaïque, vous souhaiterez utiliser le code de dessin correspondant au mode grandes icônes lors de l’exécution sur les systèmes d’exploitation qui ne prennent pas en charge l’affichage en mosaïque.

La fonctionnalité d’affichage en mosaïque est fournie par la même bibliothèque qui fournit la fonctionnalité des thèmes du système d’exploitation. Pour vérifier la disponibilité de cette bibliothèque, appelez le FeatureSupport.IsPresent(Object) la surcharge de méthode et transmettez la OSFeature.Themes valeur.

L’exemple de code suivant crée un ListView contrôle avec trois ListViewItem objets spécifiés et trois ListViewItem.ListViewSubItem objets spécifiés pour chaque élément. L’exemple crée également ColumnHeader objets pour afficher les sous-éléments en mode Détails. Deux ImageList objets sont également créés dans l’exemple de code pour fournir des images pour les ListViewItem objets. Ces ImageList objets sont ajoutés à la LargeImageList et SmallImageList Propriétés. L’exemple utilise les propriétés suivantes pour créer la ListView contrôle.

Cet exemple requiert que vous avez ajouté le code à un Form appelez la méthode créée dans l’exemple à partir du constructeur ou une autre méthode sur le formulaire. L’exemple suppose également que les images nommées MySmallImage1, MySmallImage2, MyLargeImage1, et MyLargeImage2 se trouvent dans le répertoire racine du lecteur C.

private void CreateMyListView()
{
	// Create a new ListView control.
	ListView listView1 = new ListView();
	listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200));

	// Set the view to show details.
	listView1.View = View.Details;
	// Allow the user to edit item text.
	listView1.LabelEdit = true;
	// Allow the user to rearrange columns.
	listView1.AllowColumnReorder = true;
	// Display check boxes.
	listView1.CheckBoxes = true;
	// Select the item and subitems when selection is made.
	listView1.FullRowSelect = true;
	// Display grid lines.
	listView1.GridLines = true;
	// Sort the items in the list in ascending order.
	listView1.Sorting = SortOrder.Ascending;

	// Create three items and three sets of subitems for each item.
	ListViewItem item1 = new ListViewItem("item1",0);
	// Place a check mark next to the item.
	item1.Checked = true;
	item1.SubItems.Add("1");
	item1.SubItems.Add("2");
	item1.SubItems.Add("3");
	ListViewItem item2 = new ListViewItem("item2",1);
	item2.SubItems.Add("4");
	item2.SubItems.Add("5");
	item2.SubItems.Add("6");
	ListViewItem item3 = new ListViewItem("item3",0);
	// Place a check mark next to the item.
	item3.Checked = true;
	item3.SubItems.Add("7");
	item3.SubItems.Add("8");
	item3.SubItems.Add("9");

	// Create columns for the items and subitems.
	// Width of -2 indicates auto-size.
	listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center);

	//Add the items to the ListView.
          		listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3});

	// Create two ImageList objects.
	ImageList imageListSmall = new ImageList();
	ImageList imageListLarge = new ImageList();

	// Initialize the ImageList objects with bitmaps.
	imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp"));
	imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp"));
	imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp"));
	imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp"));

	//Assign the ImageList objects to the ListView.
	listView1.LargeImageList = imageListLarge;
	listView1.SmallImageList = imageListSmall;

	// Add the ListView to the control collection.
	this.Controls.Add(listView1);
}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: