ListView.AutoResizeColumns メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ListView.AutoResizeColumns メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

列の幅を、サイズ変更スタイルで示された幅にサイズ変更します。

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

Visual Basic (宣言)

Public Sub AutoResizeColumns ( _
    headerAutoResize As ColumnHeaderAutoResizeStyle _
)

Visual Basic (使用法)

Dim instance As ListView
Dim headerAutoResize As ColumnHeaderAutoResizeStyle

instance.AutoResizeColumns(headerAutoResize)

public void AutoResizeColumns (
    ColumnHeaderAutoResizeStyle headerAutoResize
)

C++

public:
void AutoResizeColumns (
    ColumnHeaderAutoResizeStyle headerAutoResize
)

public void AutoResizeColumns (
    ColumnHeaderAutoResizeStyle headerAutoResize
)

JScript

public function AutoResizeColumns (
    headerAutoResize : ColumnHeaderAutoResizeStyle
)

パラメータ

headerAutoResize: ColumnHeaderAutoResizeStyle 値の 1 つ。

例外

例外の種類	条件
InvalidOperationException	View が Details に設定されていない場合に、None 以外の値を使用して AutoResizeColumn が呼び出されています。

解説

このメソッドの呼び出しは、ListView とそのコンテナである Form が作成されており、ListView の列ヘッダーと列に項目が追加されている場合にのみ有効です。新しい項目が ListView に追加されても、AutoResizeColumns が再度呼び出されるまで、列のサイズは変更されません。

使用例

詳細ビューで ListView を初期化し、AutoResizeColumns メソッドを使用して列のサイズを自動的に変更するコード例を次に示します。この例を実行するには、このコードを Windows フォームに貼り付け、フォームのコンストラクタまたは Load イベントハンドラから、InitializeResizingListView メソッドを呼び出します。

Visual Basic

Private resizingListView As New
 ListView()
Private WithEvents button1 As
 New Button()


Private Sub InitializeResizingListView()
    ' Set location and text for button.
    button1.Location = New Point(100, 15)
    button1.Text = "Resize"
    AddHandler button1.Click, AddressOf button1_Click

    ' Set the ListView to details view.
    resizingListView.View = View.Details

    'Set size, location and populate the ListView.
    resizingListView.Size = New Size(200, 100)
    resizingListView.Location = New Point(40, 40)
    resizingListView.Columns.Add("HeaderSize")
    resizingListView.Columns.Add("ColumnContent")
    Dim listItem1 As New
 ListViewItem("Short")
    Dim listItem2 As New
 ListViewItem("Tiny")
    listItem1.SubItems.Add(New ListViewItem.ListViewSubItem(listItem1,
 _
        "Something longer"))
    listItem2.SubItems.Add(New ListViewItem.ListViewSubItem(listItem2,
 _
        "Something even longer"))
    resizingListView.Items.Add(listItem1)
    resizingListView.Items.Add(listItem2)

    ' Add the ListView and the Button to the form.
    Me.Controls.Add(resizingListView)
    Me.Controls.Add(button1)

End Sub


Private Sub button1_Click(ByVal
 sender As Object, ByVal
 e As EventArgs) _
    Handles button1.Click

    ' Resize the first column to the header size.
    resizingListView.AutoResizeColumn(0, _
        ColumnHeaderAutoResizeStyle.HeaderSize)

    ' Resize the second column to the column content.
    resizingListView.AutoResizeColumn(1, _
        ColumnHeaderAutoResizeStyle.ColumnContent)

End Sub

private ListView resizingListView = new ListView();
private Button button1 = new Button();

private void InitializeResizingListView()
{
    // Set location and text for button.
    button1.Location = new Point(100, 15);
    button1.Text = "Resize";
    button1.Click += new EventHandler(button1_Click);

    // Set the ListView to details view.
    resizingListView.View = View.Details;

    //Set size, location and populate the ListView.
    resizingListView.Size = new Size(200, 100);
    resizingListView.Location = new Point(40, 40);
    resizingListView.Columns.Add("HeaderSize");
    resizingListView.Columns.Add("ColumnContent");
    ListViewItem listItem1 = new ListViewItem("Short");
    ListViewItem listItem2 = new ListViewItem("Tiny");
    listItem1.SubItems.Add(new ListViewItem.ListViewSubItem( 
            listItem1, "Something longer"));
    listItem2.SubItems.Add(new ListViewItem.ListViewSubItem(
        listItem2, "Something even longer"));
    resizingListView.Items.Add(listItem1);
    resizingListView.Items.Add(listItem2);

    // Add the ListView and the Button to the form.
    this.Controls.Add(resizingListView);
    this.Controls.Add(button1);
}

private void button1_Click(object sender, EventArgs
 e)
{
    resizingListView.AutoResizeColumn(0, 
        ColumnHeaderAutoResizeStyle.HeaderSize);
    resizingListView.AutoResizeColumn(1, 
        ColumnHeaderAutoResizeStyle.ColumnContent);
}