ListView.HeaderStyle ListView.HeaderStyle ListView.HeaderStyle ListView.HeaderStyle Property

Définition

Obtient ou définit le style des en-têtes de colonnes.Gets or sets the column header style.

public:
 property System::Windows::Forms::ColumnHeaderStyle HeaderStyle { System::Windows::Forms::ColumnHeaderStyle get(); void set(System::Windows::Forms::ColumnHeaderStyle value); };
public System.Windows.Forms.ColumnHeaderStyle HeaderStyle { get; set; }
member this.HeaderStyle : System.Windows.Forms.ColumnHeaderStyle with get, set
Public Property HeaderStyle As ColumnHeaderStyle

Valeur de propriété

Une des valeurs de l'objet ColumnHeaderStyle.One of the ColumnHeaderStyle values. La valeur par défaut est Clickable.The default is Clickable.

Exceptions

La valeur spécifiée n'est pas l'une des valeurs ColumnHeaderStyle.The value specified is not one of the ColumnHeaderStyle values.

Exemples

L’exemple de code suivant montre ListView un qui autorise la sélection de plusieurs éléments.The following code example demonstrates a ListView that allows multiple items to be selected. L’exemple illustre la définition HideSelection des HeaderStyle propriétés et.The example demonstrates setting the HideSelection and HeaderStyle properties. Il illustre également les ColumnHeader.Textpropriétés ColumnHeader.TextAlign , ColumnHeader.Width et.It also demonstrates the ColumnHeader.Text, ColumnHeader.TextAlign and ColumnHeader.Width properties. Pour exécuter cet exemple, collez le code suivant dans un formulaire qui contient ListView un objet ListView1 nommé et TextBox un TextBox1nommé.To run this example, paste the following code into a form that contains a ListView object named ListView1 and a TextBox named TextBox1. Appelez la InitializeListView méthode à partir du constructeur du formulaire Load ou du gestionnaire d’événements.Call the InitializeListView method from the form's constructor or Load event handler.

// 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.
void InitializeListView()
{
   this->ListView1 = gcnew System::Windows::Forms::ListView;
   this->ListView1->BackColor = System::Drawing::SystemColors::Control;
   this->ListView1->Dock = System::Windows::Forms::DockStyle::Top;
   this->ListView1->Location = System::Drawing::Point( 0, 0 );
   this->ListView1->Name = "ListView1";
   this->ListView1->Size = 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 = gcnew ColumnHeader;
   columnHeader1->Text = "Breakfast Item";
   columnHeader1->TextAlign = HorizontalAlignment::Left;
   columnHeader1->Width = 146;
   ColumnHeader^ columnHeader2 = gcnew ColumnHeader;
   columnHeader2->Text = "Price Each";
   columnHeader2->TextAlign = HorizontalAlignment::Center;
   columnHeader2->Width = 142;
   this->ListView1->Columns->Add( columnHeader1 );
   this->ListView1->Columns->Add( columnHeader2 );
   array<String^>^foodList = {"Juice","Coffee","Cereal & Milk","Fruit Plate","Toast & Jelly","Bagel & Cream Cheese"};
   array<String^>^foodPrice = {"1.09","1.09","2.19","2.49","1.49","1.49"};
   for ( int count = 0; count < foodList->Length; count++ )
   {
      ListViewItem^ listItem = gcnew ListViewItem( foodList[ count ] );
      listItem->SubItems->Add( foodPrice[ count ] );
      ListView1->Items->Add( listItem );

   }
   this->Controls->Add( ListView1 );
}
  // 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);
  }
  
' 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 Sub InitializeListView()
    Me.ListView1 = New System.Windows.Forms.ListView
    Me.ListView1.BackColor = System.Drawing.SystemColors.Control
    Me.ListView1.Dock = System.Windows.Forms.DockStyle.Top
    Me.ListView1.Location = New System.Drawing.Point(0, 0)
    Me.ListView1.Name = "ListView1"
    Me.ListView1.Size = New System.Drawing.Size(292, 130)
    Me.ListView1.TabIndex = 0
    Me.ListView1.View = System.Windows.Forms.View.Details
    Me.ListView1.MultiSelect = True
    Me.ListView1.HideSelection = False
    ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable
    Dim columnHeader1 As New ColumnHeader
    With columnHeader1
        .Text = "Breakfast Item"
        .TextAlign = HorizontalAlignment.Left
        .Width = 146
    End With
    Dim columnHeader2 As New ColumnHeader
    With columnHeader2
        .Text = "Price Each"
        .TextAlign = HorizontalAlignment.Center
        .Width = 142
    End With

    Me.ListView1.Columns.Add(columnHeader1)
    Me.ListView1.Columns.Add(columnHeader2)
    Dim foodList() As String = New String() {"Juice", "Coffee", _
        "Cereal & Milk", "Fruit Plate", "Toast & Jelly", _
        "Bagel & Cream Cheese"}
    Dim foodPrice() As String = New String() {"1.09", "1.09", _
        "2.19", "2.49", "1.49", "1.49"}
    Dim count As Integer
    For count = 0 To foodList.Length - 1
        Dim listItem As New ListViewItem(foodList(count))
        listItem.SubItems.Add(foodPrice(count))
        ListView1.Items.Add(listItem)
    Next
    Me.Controls.Add(Me.ListView1)
End Sub

Remarques

La HeaderStyle propriété vous permet de spécifier le type d’en-têtes de colonnes à afficher View lorsque la propriété ListView du contrôle a la Details valeur et ListView que le ColumnHeader contrôle a des objets spécifiés dans l' objetListView.ColumnHeaderCollection.The HeaderStyle property allows you to specify the type of column headers to display when the View property of the ListView control is set to Details and the ListView control has ColumnHeader objects specified in the ListView.ColumnHeaderCollection. ColumnHeaderles objets définissent les colonnes qui sont ListView affichées dans le contrôle.ColumnHeader objects define the columns that are displayed in the ListView control. Chaque colonne est utilisée pour afficher des informations de sous-élément pour ListViewchaque élément dans.Each column is used to display subitem information for each item in the ListView.

La HeaderStyle propriété vous permet de spécifier si les en-têtes de colonnes sont visibles ou, s’ils sont visibles, s’ils fonctionnent comme des boutons intercliquables.The HeaderStyle property allows you to specify whether the column headers are visible or, if they are visible, whether they will function as clickable buttons. Si la HeaderStyle propriété a la ColumnHeaderStyle.Nonevaleur, les en-têtes de colonne ne sont pas affichés, bien que les éléments ListView et les sous-éléments du contrôle soient toujours organisés en colonnes.If the HeaderStyle property is set to ColumnHeaderStyle.None, the column headers are not displayed, although the items and subitems of the ListView control are still arranged in columns. Si la HeaderStyle propriété a la ColumnHeaderStyle.Clickablevaleur, les en-têtes de colonnes agissent comme des boutons sur lesquels les utilisateurs peuvent cliquer pour exécuter une action, par exemple ListView trier les éléments du contrôle à l’aide des éléments de la colonne sur laquelle vous avez cliqué en tant que clé.If the HeaderStyle property is set to ColumnHeaderStyle.Clickable, the column headers act like buttons that users can click to carry out an action, such as sorting the items in the ListView control using the items in the clicked column as a key. Vous pouvez implémenter ce comportement dans un gestionnaire pour ColumnClick l’événement.You can implement this behavior in a handler for the ColumnClick event. Si la HeaderStyle propriété a la ColumnHeaderStyle.Nonclickablevaleur, les en-têtes de colonnes s’affichent, mais vous ne pouvez pas cliquer dessus.If the HeaderStyle property is set to ColumnHeaderStyle.Nonclickable, the column headers appear, but cannot be clicked.

S’applique à

Voir aussi