ListView.HeaderStyle Özellik

Tanım

Sütun başlığı stilini alır veya ayarlar.

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

Özellik Değeri

Değerlerden ColumnHeaderStyle biri. Varsayılan değer: Clickable.

Özel durumlar

Belirtilen değer değerlerden ColumnHeaderStyle biri değil.

Örnekler

Aşağıdaki kod örneğinde, birden çok öğenin seçilmesine izin veren bir ListView gösterilmektedir. Örnekte ve HeaderStyle özelliklerinin ayarlanması HideSelection gösterilmektedir. Ayrıca , ColumnHeader.TextAlign ve ColumnHeader.Width özelliklerini de gösterirColumnHeader.Text. Bu örneği çalıştırmak için, aşağıdaki kodu adlı ve adlı TextBox1ListView1 bir nesneyi içeren bir ListViewTextBox forma yapıştırın. Formun InitializeListView oluşturucusundan veya Load olay işleyicisinden yöntemini çağırın.

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

Açıklamalar

özelliği, HeaderStyle denetimin özelliği ListView olarak ayarlandığında Details ve ListView denetimin içinde belirtilen nesnelere sahip ColumnHeader olduğunda View görüntülenecek sütun üst bilgilerinin türünü belirtmenize ListView.ColumnHeaderCollectionolanak tanır. ColumnHeader nesneler, denetimde ListView görüntülenen sütunları tanımlar. Her sütun içindeki her öğe için alt öğe ListViewbilgilerini görüntülemek için kullanılır.

HeaderStyle özelliği, sütun üst bilgilerinin görünür olup olmadığını veya görünür olup olmadıklarını, tıklanabilir düğmeler olarak çalışıp çalışmayacağını belirtmenize olanak tanır. HeaderStyle özelliği olarak ayarlanırsaColumnHeaderStyle.None, denetimin öğeleri ve alt ListView öğeleri hala sütunlar halinde düzenlenmiş olsa da sütun başlıkları görüntülenmez. HeaderStyle özelliği olarak ayarlanırsaColumnHeaderStyle.Clickable, sütun üst bilgileri, tıklanan sütundaki öğeleri anahtar olarak kullanarak denetimdeki ListView öğeleri sıralama gibi bir eylemi gerçekleştirmek için kullanıcıların tıklayabileceği düğmeler gibi davranır. Bu davranışı olay için bir işleyicide ColumnClick uygulayabilirsiniz. HeaderStyle özelliği olarak ayarlanırsaColumnHeaderStyle.Nonclickable, sütun başlıkları görünür, ancak tıklanamaz.

Şunlara uygulanır

Ürün Sürümler
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Ayrıca bkz.