ListView.AutoResizeColumns(ColumnHeaderAutoResizeStyle) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ändert die Breite der Spalten gemäß der Formatvorlage für die Größenänderung.

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)

Parameter

headerAutoResize

ColumnHeaderAutoResizeStyle

Einer der ColumnHeaderAutoResizeStyle-Werte.

Ausnahmen

InvalidOperationException

AutoResizeColumn(Int32, ColumnHeaderAutoResizeStyle) wird mit einem anderen Wert als None aufgerufen, wenn View nicht auf Details festgelegt ist.

Beispiele

Im folgenden Codebeispiel wird die Initialisierung einer ListView Detailansicht veranschaulicht und die Größe der Spalten mithilfe der AutoResizeColumns Methode automatisch geändert. Um dieses Beispiel auszuführen, fügen Sie diesen Code in ein Windows Formular ein, und rufen Sie die InitializeResizingListView2 Methode vom Konstruktor oder Load Ereignishandler des Formulars auf.

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

Hinweise

Das Aufrufen dieser Methode ist nur wirksam, wenn die ListView und die enthaltenden Form Elemente erstellt wurden, und die ListView Spaltenüberschriften und Spalten werden mit Elementen gefüllt. Wenn neue Elemente dem Hinzugefügt werden, wird die Größe der ListViewSpalten nicht geändert, es sei AutoResizeColumns denn, es wird erneut aufgerufen.