Listview headerstyle

ListView.HeaderStyle プロパティ

アプリで見るアプリで見る

列ヘッダーのスタイルを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)
Public Property HeaderStyle As ColumnHeaderStyle
Visual Basic (使用法)
Dim instance As ListView Dim value As ColumnHeaderStyle value = instance.HeaderStyle instance.HeaderStyle = value
C#
public ColumnHeaderStyle HeaderStyle { get; set; }
C++
public: property ColumnHeaderStyle HeaderStyle { ColumnHeaderStyle get (); void set (ColumnHeaderStyle value); }
J#
/** @property */ public ColumnHeaderStyle get_HeaderStyle () /** @property */ public void set_HeaderStyle (ColumnHeaderStyle value)
JScript
public function get HeaderStyle () : ColumnHeaderStyle public function set HeaderStyle (value : ColumnHeaderStyle)

プロパティ値
ColumnHeaderStyle 値の 1 つ。既定値は Clickable です。

例外
例外の種類条件

InvalidEnumArgumentException

指定された値が ColumnHeaderStyle 値ではありません。

解説

HeaderStyle プロパティを使用すると、ListView コントロールの View プロパティが Details に設定され、ListView コントロールに ListView.ColumnHeaderCollection に指定された ColumnHeader オブジェクトがある場合に、表示する列ヘッダーの種類を指定できます。ColumnHeader オブジェクトは ListView コントロールに表示される列を定義します。各列は、ListView の各項目のサブ項目情報を表示するのに使用します。

HeaderStyle プロパティを使用すると、列ヘッダーが表示されているかどうか、または列ヘッダーが表示されている場合はクリックできるボタンとして機能するかどうかを指定できます。HeaderStyle プロパティが ColumnHeaderStyle.None に設定されている場合、ListView コントロール内の項目とサブ項目は列に配置されますが、列ヘッダーは表示されません。HeaderStyle プロパティが ColumnHeaderStyle.Clickable に設定されている場合、列ヘッダーは、クリックされた列の項目をキーとして使用する ListView コントロールの項目の並べ替えなどのアクションを実行するために、ユーザーがクリックできるボタンとして機能します。この動作は、ColumnClick イベントのハンドラで実装できます。HeaderStyle プロパティが ColumnHeaderStyle.Nonclickable に設定されている場合、列ヘッダーは表示されますが、クリックできません。

使用例

複数項目を選択できる ListView のコード例を次に示します。この例では、HideSelection プロパティと HeaderStyle プロパティの設定を示しています。また、この例では ColumnHeader.Text、ColumnHeader.TextAlign、および ColumnHeader.Width の各プロパティも示しています。この例を実行するには、ListView1 という名前の ListView オブジェクトと TextBox1 という名前の TextBox が配置されているフォームに次のコードを貼り付けます。次に、フォームのコンストラクタまたは Load のイベント ハンドラで InitializeListView メソッドを呼び出します。

Visual Basic
' 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
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); }
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. 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^foodList = {"Juice","Coffee","Cereal & Milk","Fruit Plate","Toast & Jelly","Bagel & Cream Cheese"}; array^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 ); }
J#
// 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.set_BackColor( System.Drawing.SystemColors.get_Control()); this.listView1.set_Dock(System.Windows.Forms.DockStyle.Top); this.listView1.set_Location(new System.Drawing.Point(0, 0)); this.listView1.set_Name("listView1"); this.listView1.set_Size(new System.Drawing.Size(292, 130)); this.listView1.set_TabIndex(0); this.listView1.set_View(System.Windows.Forms.View.Details); this.listView1.set_MultiSelect(true); this.listView1.set_HideSelection(false); this.listView1.set_HeaderStyle(ColumnHeaderStyle.Nonclickable); ColumnHeader columnHeader1 = new ColumnHeader(); columnHeader1.set_Text("Breakfast Item"); columnHeader1.set_TextAlign(HorizontalAlignment.Left); columnHeader1.set_Width(146); ColumnHeader columnHeader2 = new ColumnHeader(); columnHeader2.set_Text("Price Each"); columnHeader2.set_TextAlign(HorizontalAlignment.Center); columnHeader2.set_Width(142); this.listView1.get_Columns().Add(columnHeader1); this.listView1.get_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.get_Length(); count++) { ListViewItem listItem = new ListViewItem( foodList.get_Item(count).ToString()); listItem.get_SubItems().Add(foodPrice.get_Item(count).ToString()); listView1.get_Items().Add(listItem); } this.get_Controls().Add(listView1); } //InitializeListView
プラットフォーム

Windows98, Windows2000SP4, WindowsCE, WindowsMillenniumEdition, WindowsMobileforPocketPC, WindowsMobileforSmartphone, WindowsServer2003, WindowsXPMediaCenterEdition, WindowsXPProfessionalx64Edition, WindowsXPSP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照
関連項目
ListView クラス
ListView メンバ
System.Windows.Forms 名前空間
ColumnClick
ColumnHeaderStyle 列挙体
View
View