次の方法で共有

ListView.HeaderStyle プロパティ

  • [アーティクル]

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

Public Property HeaderStyle As ColumnHeaderStyle
[C#]
public ColumnHeaderStyle HeaderStyle {get; set;}
[C++]
public: __property ColumnHeaderStyle get_HeaderStyle();public: __property void set_HeaderStyle(ColumnHeaderStyle);
[JScript]
public function get HeaderStyle() : ColumnHeaderStyle;public function set HeaderStyle(ColumnHeaderStyle);

プロパティ値

ColumnHeaderStyle 値の 1 つ。既定値は ColumnHeaderStyle.Clickable です。

例外

例外の種類 条件
InvalidEnumArgumentException 指定された値が ColumnHeaderStyle 値ではありません。

解説

HeaderStyle プロパティを使用すると、 ListView コントロールの View プロパティが View.Details に設定され、 ListView コントロールに ListView.ColumnHeaderCollection に指定された ColumnHeader オブジェクトがある場合に、表示する列ヘッダーの種類を指定できます。 ColumnHeader オブジェクトは ListView コントロールに表示される列を定義します。各列は、 ListView の各項目のサブ項目情報を表示するのに使用します。 HeaderStyle プロパティを使用すると、列ヘッダーがクリックできるボタンとして機能するかどうかを指定できます。 HeaderStyle プロパティが ColumnHeaderStyle.Clickable に設定されている場合、列ヘッダーは、クリックされた列の項目をキーとして使用する ListView コントロールの項目の並べ替えなどのアクションを実行するために、ユーザーがクリックできるボタンとして機能します。また、すべての列ヘッダーを非表示にするために HeaderStyle プロパティを ColumnHeaderStyle.None にも設定できます。

使用例

[Visual Basic, C#] HeaderStyle プロパティをクリック不可能に設定して ListView コントロールを初期化するコード例を次に示します。 BeginUpdate メソッドおよび EndUpdate メソッドの使用例も示します。この例を実行するには、ListView1 という名前の ListView が配置されているフォームに、次のコードを貼り付けます。そして、フォームのコンストラクタまたは Load メソッドから InititalizeListView メソッドを呼び出します。

 
Private Sub InitializeListView()
    Me.ListView1 = New System.Windows.Forms.ListView

    ' Set properties such as BackColor, Location and Size
    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.Size = New System.Drawing.Size(292, 130)
    Me.ListView1.View = System.Windows.Forms.View.Details
    Me.ListView1.HideSelection = False

    ' Allow user to select multiple items.
    Me.ListView1.MultiSelect = True

    ' Show check boxes in the ListView.
    Me.ListView1.CheckBoxes = True

    'Set the column headers and populate the columns.
    ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable
    Dim columnHeader1 As New ColumnHeader
    With columnHeader1
        .Text = "Breakfast Choices"
        .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.79", "2.09", "2.69"}
    Dim count As Integer

    ' Members are added one at a time, so call BeginUpdate to ensure 
    ' the list is painted only once, rather than as each list item is added.
    ListView1.BeginUpdate()

    For count = 0 To foodList.Length - 1
        Dim listItem As New ListViewItem(foodList(count))
        listItem.SubItems.Add(foodPrice(count))
        ListView1.Items.Add(listItem)
    Next

    'Call EndUpdate when you finish adding items to the ListView.
    ListView1.EndUpdate()
    Me.Controls.Add(Me.ListView1)
End Sub

[C#] 
private void InitializeListView()
{
    this.ListView1 = new System.Windows.Forms.ListView();

    // Set properties such as BackColor and DockStyle and Location.
    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.Size = new System.Drawing.Size(292, 130);
    this.ListView1.View = System.Windows.Forms.View.Details;
    this.ListView1.HideSelection = false;

    // Allow the user to select multiple items.
    this.ListView1.MultiSelect = true;

    // Show CheckBoxes in the ListView.
    this.ListView1.CheckBoxes = true;
    
    //Set the column headers and populate the columns.
    ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable;
    
    ColumnHeader columnHeader1 = new ColumnHeader();
    columnHeader1.Text = "Breakfast Choices";
    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.79", "2.09", "2.69"};
    
    int count;

    // Members are added one at a time, so call BeginUpdate to ensure 
    // the list is painted only once, rather than as each list item is added.
    ListView1.BeginUpdate();

    for(count = 0; count < foodList.Length; count++)
    {
        ListViewItem listItem = new ListViewItem(foodList[count]);
        listItem.SubItems.Add(foodPrice[count]);
        ListView1.Items.Add(listItem);
    }

    //Call EndUpdate when you finish adding items to the ListView.
    ListView1.EndUpdate();
    this.Controls.Add(this.ListView1);
}

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

ListView クラス | ListView メンバ | System.Windows.Forms 名前空間 | ColumnHeaderStyle | View | View