This documentation is archived and is not being maintained.

ListView.AutoResizeColumns Method

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

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public void AutoResizeColumns(
	ColumnHeaderAutoResizeStyle headerAutoResize
)

Parameters

headerAutoResize
Type: System.Windows.Forms.ColumnHeaderAutoResizeStyle

One of the ColumnHeaderAutoResizeStyle values.

ExceptionCondition
InvalidOperationException

AutoResizeColumn is called with a value other than None when View is not set to Details.

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.

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

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: