ListView.HeaderStyle Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

ListView.cs

Obtiene o establece el estilo del encabezado de columna.

C#

public System.Windows.Forms.ColumnHeaderStyle HeaderStyle { get; set; }

Valor de propiedad

ColumnHeaderStyle

Uno de los valores de ColumnHeaderStyle. De manera predeterminada, es Clickable.

Excepciones

InvalidEnumArgumentException

El valor especificado no es ninguno de los valores de ColumnHeaderStyle.

Ejemplos

En el ejemplo de código siguiente se muestra un ListView que permite seleccionar varios elementos. En el ejemplo se muestra cómo establecer las HideSelection propiedades y HeaderStyle . También muestra las ColumnHeader.Textpropiedades , ColumnHeader.TextAlign y ColumnHeader.Width . Para ejecutar este ejemplo, pegue el código siguiente en un formulario que contenga un ListView objeto denominado ListView1 y un TextBox denominado TextBox1. Llame al InitializeListView método desde el constructor o Load el controlador de eventos del formulario.

C#

  // 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);
  }

Comentarios

La HeaderStyle propiedad permite especificar el tipo de encabezados de columna que se van a mostrar cuando la View propiedad del ListView control se establece Details en y el ListView control tiene ColumnHeader objetos especificados en .ListView.ColumnHeaderCollection ColumnHeader los objetos definen las columnas que se muestran en el ListView control . Cada columna se usa para mostrar información de subelemento para cada elemento de .ListView

La HeaderStyle propiedad permite especificar si los encabezados de columna son visibles o, si son visibles, si funcionarán como botones que se pueden hacer clic. Si la HeaderStyle propiedad se establece ColumnHeaderStyle.Noneen , no se muestran los encabezados de columna, aunque los elementos y subelementos del ListView control se siguen organizando en columnas. Si la HeaderStyle propiedad está establecida ColumnHeaderStyle.Clickableen , los encabezados de columna actúan como botones que los usuarios pueden hacer clic para llevar a cabo una acción, como ordenar los elementos del ListView control mediante los elementos de la columna en la que se hace clic como una clave. Puede implementar este comportamiento en un controlador para el ColumnClick evento. Si la HeaderStyle propiedad está establecida ColumnHeaderStyle.Nonclickableen , aparecen los encabezados de columna, pero no se puede hacer clic en ella.

Se aplica a

Consulte también

• ColumnClick
• ColumnHeaderStyle
• View
• View