Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

ListView.HeaderStyle, propriété

Obtient ou définit le style des en-têtes de colonnes.

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

public ColumnHeaderStyle HeaderStyle { get; set; }

Valeur de propriété

Type : System.Windows.Forms.ColumnHeaderStyle
Une des valeurs de ColumnHeaderStyle. La valeur par défaut est Clickable.

ExceptionCondition
InvalidEnumArgumentException

La valeur spécifiée n'est pas l'une des valeurs ColumnHeaderStyle.

La propriété HeaderStyle vous permet de spécifier le type d'en-tête de colonne à afficher lorsque la propriété View du contrôle ListView a la valeur Details et que le contrôle ListView a des objets ColumnHeader spécifiés dans ListView.ColumnHeaderCollection. Les objets ColumnHeader définissent les colonnes affichées dans le contrôle ListView. Chaque colonne permet d'afficher des informations relatives aux sous-éléments de chaque élément de ListView.

La propriété HeaderStyle permet de spécifier si les en-têtes de colonnes sont visibles, et s'ils le sont, s'ils fonctionnent comme des boutons interactifs. Si la propriété HeaderStyle a la valeur ColumnHeaderStyle.None, les en-têtes de colonnes ne sont pas affichés, bien que les éléments et les sous-éléments du contrôle ListView soient toujours disposés en colonnes. Si la propriété HeaderStyle a la valeur ColumnHeaderStyle.Clickable, les en-têtes de colonnes fonctionnent comme des boutons sur lesquels l'utilisateur peut cliquer pour effectuer une action, par exemple pour trier les éléments du contrôle ListView en fonction des éléments figurant dans la colonne sélectionnée. Vous pouvez implémenter ce comportement dans un gestionnaire de l'événement ColumnClick. Si la propriété HeaderStyle a la valeur ColumnHeaderStyle.Nonclickable, les en-têtes de colonnes apparaissent, mais l'utilisateur ne peut pas cliquer dessus.

L'exemple de code suivant illustre un ListView qui permet de sélectionner plusieurs éléments. L'exemple illustre la définition des propriétés HideSelection et HeaderStyle. Il présente également les propriétés ColumnHeader.Text, ColumnHeader.TextAlign et ColumnHeader.Width. Pour exécuter cet exemple, collez le code suivant dans un formulaire contenant un objet ListView nommé ListView1 et un TextBox nommé TextBox1. Appelez la méthode InitializeListView depuis le constructeur du formulaire ou le gestionnaire d'événements Load.


	// This method adds two columns to the ListView, setting the Text 
	// and TextAlign, and Width properties of each ColumnHeader.  The 
	// HeaderStyle property is set to NonClickable since the ColumnClick 
	// event is not handled.  Finally the method adds ListViewItems and 
	// SubItems to each column.
	private void InitializeListView()
	{
		this.ListView1 = new System.Windows.Forms.ListView();
		this.ListView1.BackColor = System.Drawing.SystemColors.Control;
		this.ListView1.Dock = System.Windows.Forms.DockStyle.Top;
		this.ListView1.Location = new System.Drawing.Point(0, 0);
		this.ListView1.Name = "ListView1";
		this.ListView1.Size = new System.Drawing.Size(292, 130);
		this.ListView1.TabIndex = 0;
		this.ListView1.View = System.Windows.Forms.View.Details;
		this.ListView1.MultiSelect = true;
		this.ListView1.HideSelection = false;
		this.ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable;
		
		ColumnHeader columnHeader1 = new ColumnHeader();
		columnHeader1.Text = "Breakfast Item";
		columnHeader1.TextAlign = HorizontalAlignment.Left;
		columnHeader1.Width = 146;

	 	ColumnHeader columnHeader2 = new ColumnHeader();
		columnHeader2.Text = "Price Each";
		columnHeader2.TextAlign = HorizontalAlignment.Center;
		columnHeader2.Width = 142;

		this.ListView1.Columns.Add(columnHeader1);
		this.ListView1.Columns.Add(columnHeader2);

		string[] foodList = new string[]{"Juice", "Coffee", 
			"Cereal & Milk", "Fruit Plate", "Toast & Jelly", 
			"Bagel & Cream Cheese"};
		string[] foodPrice = new string[]{"1.09", "1.09", "2.19", 
			"2.49", "1.49", "1.49"};
		
		for(int count=0; count < foodList.Length; count++)
		{
			ListViewItem listItem = new ListViewItem(foodList[count]);
			listItem.SubItems.Add(foodPrice[count]);
			ListView1.Items.Add(listItem);
		}
		this.Controls.Add(ListView1);
	}
	


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft