ListView.AutoResizeColumns(ColumnHeaderAutoResizeStyle) Method

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Source:: ListView.cs

Source:: ListView.cs

Source:: ListView.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Resizes the width of the columns as indicated by the resize style.

public:
 void AutoResizeColumns(System::Windows::Forms::ColumnHeaderAutoResizeStyle headerAutoResize);

public void AutoResizeColumns (System.Windows.Forms.ColumnHeaderAutoResizeStyle headerAutoResize);

member this.AutoResizeColumns : System.Windows.Forms.ColumnHeaderAutoResizeStyle -> unit

Public Sub AutoResizeColumns (headerAutoResize As ColumnHeaderAutoResizeStyle)

Parameters

headerAutoResize: ColumnHeaderAutoResizeStyle

One of the ColumnHeaderAutoResizeStyle values.

Exceptions

InvalidOperationException

AutoResizeColumn(Int32, ColumnHeaderAutoResizeStyle) is called with a value other than None when View is not set to Details.

Examples

The following code example demonstrates initializing a ListView in detail view and automatically resizing the columns using the AutoResizeColumns method. To run this example, paste this code into a Windows Form and call the InitializeResizingListView2 method from the form's constructor or Load event handler.

private ListView resizingListView2 = new ListView();
private Button resizeButton = new Button();

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

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

    //Set size, location and populate the ListView.
    resizingListView2.Size = new Size(200, 100);
    resizingListView2.Location = new Point(40, 40);
    resizingListView2.Columns.Add("HeaderSize");
    resizingListView2.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"));
    resizingListView2.Items.Add(listItem1);
    resizingListView2.Items.Add(listItem2);

    // Add the ListView and the Button to the form.
    this.Controls.Add(resizingListView2);
    this.Controls.Add(resizeButton);
}

private void resizeButton_Click(object sender, EventArgs e)
{
    resizingListView2.AutoResizeColumns(ColumnHeaderAutoResizeStyle.HeaderSize);
}

Private resizingListView2 As New ListView()
Private WithEvents resizeButton As New Button()


Private Sub InitializeResizingListView2() 

    ' Set location and text for button.
    resizeButton.Location = New Point(100, 15)
    resizeButton.Text = "Resize"

    ' Set the ListView to details view.
    resizingListView2.View = View.Details
    
    'Set size, location and populate the ListView.
    resizingListView2.Size = New Size(200, 100)
    resizingListView2.Location = New Point(40, 40)
    resizingListView2.Columns.Add("HeaderSize")
    resizingListView2.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"))
    resizingListView2.Items.Add(listItem1)
    resizingListView2.Items.Add(listItem2)
    
    ' Add the ListView and the Button to the form.
    Me.Controls.Add(resizingListView2)
    Me.Controls.Add(resizeButton)

End Sub

Private Sub resizeButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles resizeButton.Click

    resizingListView2.AutoResizeColumns(ColumnHeaderAutoResizeStyle.HeaderSize)
End Sub

Remarks

Calling this method is only effective once the ListView and containing Form have been constructed, and the ListView column headers and columns are populated with items. If new items are added to the ListView, the columns will not resize unless AutoResizeColumns is called again.

Applies to

Jaa