ListView.AutoResizeColumn Method
Resizes the width of the given column as indicated by the resize style.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public void AutoResizeColumn( int columnIndex, ColumnHeaderAutoResizeStyle headerAutoResize )
Parameters
- columnIndex
- Type: System.Int32
The zero-based index of the column to resize.
- headerAutoResize
- Type: System.Windows.Forms.ColumnHeaderAutoResizeStyle
One of the ColumnHeaderAutoResizeStyle values.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException |
columnIndex is greater than 0 when Columns is null -or- columnIndex is less than 0 or greater than the number of columns set. |
| InvalidEnumArgumentException |
headerAutoResize is not a member of the ColumnHeaderAutoResizeStyle enumeration. |
The following code example demonstrates initializing a ListView in detail view and automatically resizing the columns using the AutoResizeColumn method. To run this example, paste this code into a Windows Form and call the InitializeResizingListView method from the form's constructor or Load event handler.
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 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
