ListView.HeaderStyle 속성

  • 참조

정의

네임스페이스:
System.Windows.Forms
어셈블리:
System.Windows.Forms.dll

열 머리글 스타일을 가져오거나 설정합니다.

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

속성 값

ColumnHeaderStyle

ColumnHeaderStyle 값 중 하나입니다. 기본값은 Clickable입니다.

예외

InvalidEnumArgumentException

지정된 값이 ColumnHeaderStyle 값 중 하나가 아닌 경우

예제

다음 코드 예제에서는 ListView 여러 항목을 선택할 수 있도록 하는 합니다. 이 예제에서는 및 HeaderStyle 속성을 설정하는 방법을 HideSelection 보여 줍니다. 또한 , ColumnHeader.TextAlign 및 ColumnHeader.Width 속성을 보여 줍니다ColumnHeader.Text. 이 예제를 실행하려면 다음 코드를 라는 개체와 라는 ListView1TextBox1개체가 포함된 ListView 양식에 TextBox 붙여넣습니다. 폼의 InitializeListView 생성자 또는 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.
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

설명

속성을 HeaderStyle 사용하면 컨트롤의 속성이 로 설정되고 ColumnHeaderListView 컨트롤에 에 지정된 개체가 있을 때 View 표시할 Details 열 머리글의 ListView 형식을 ListView.ColumnHeaderCollection지정할 수 있습니다. ColumnHeader 개체는 컨트롤에 ListView 표시되는 열을 정의합니다. 각 열은 의 각 항목에 대한 하위 항목 ListView정보를 표시하는 데 사용됩니다.

HeaderStyle 속성을 사용하면 열 머리글이 표시되는지 또는 열 머리글이 표시되는지, 클릭 가능한 단추로 작동하는지 여부를 지정할 수 있습니다. 속성이 HeaderStyle 로 설정된 ColumnHeaderStyle.None경우 열 머리글은 표시되지 않지만 컨트롤의 ListView 항목과 하위 항목은 열로 정렬됩니다. 속성이 HeaderStyle 로 설정된 ColumnHeaderStyle.Clickable경우 열 머리글은 클릭된 열의 항목을 키로 사용하여 컨트롤의 항목을 ListView 정렬하는 등의 작업을 수행하기 위해 클릭할 수 있는 단추처럼 작동합니다. 이벤트에 대한 처리기에서 이 동작을 구현할 ColumnClick 수 있습니다. 속성이 로 HeaderStyle 설정된 ColumnHeaderStyle.Nonclickable경우 열 머리글이 표시되지만 클릭할 수 없습니다.

적용 대상

추가 정보