ListView.AutoResizeColumns メソッド

.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)

C#

public void AutoResizeColumns (
    ColumnHeaderAutoResizeStyle headerAutoResize
)

C++

public:
void AutoResizeColumns (
    ColumnHeaderAutoResizeStyle headerAutoResize
)

J#

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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ListView クラス
ListView メンバ
System.Windows.Forms 名前空間