Metodo ListView.AutoResizeColumn (System.Windows.Forms)

Cambia visualizzazione:
Classica
Lightweight
ScriptFree
Riferimento a .NET Framework
Metodo ListView.AutoResizeColumn

Nota: questo metodo è stato introdotto con .NET Framework versione 2.0.

Ridimensiona la larghezza di una colonna fornita come indicato dallo stile di ridimensionamento.

Spazio dei nomi: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Sintassi
Visual Basic - (Dichiarazione)
Public Sub AutoResizeColumn ( _
	columnIndex As Integer, _
	headerAutoResize As ColumnHeaderAutoResizeStyle _
)
Visual Basic (Utilizzo)
Dim instance As ListView
Dim columnIndex As Integer
Dim headerAutoResize As ColumnHeaderAutoResizeStyle

instance.AutoResizeColumn(columnIndex, headerAutoResize)
C#
public void AutoResizeColumn (
	int columnIndex,
	ColumnHeaderAutoResizeStyle headerAutoResize
)
C++
public:
void AutoResizeColumn (
	int columnIndex, 
	ColumnHeaderAutoResizeStyle headerAutoResize
)
J#
public void AutoResizeColumn (
	int columnIndex, 
	ColumnHeaderAutoResizeStyle headerAutoResize
)
JScript
public function AutoResizeColumn (
	columnIndex : int, 
	headerAutoResize : ColumnHeaderAutoResizeStyle
)

Parametri

columnIndex

Indice in base zero della colonna da ridimensionare.

headerAutoResize

Uno dei valori di ColumnHeaderAutoResizeStyle.

Eccezioni
Tipo di eccezione Condizione

ArgumentOutOfRangeException

Il parametro columnIndex è maggiore di 0 se la proprietà Columns è riferimento null (Nothing in Visual Basic)

-oppure-

Il parametro columnIndex è minore di 0 o maggiore del numero di colonne impostato.

InvalidEnumArgumentException

Il parametro headerAutoResize non è un membro dell'enumerazione ColumnHeaderAutoResizeStyle.
Note

La chiamata a questo metodo ha effetto solo dopo aver costruito la classe ListView e la classe contenente Form e dopo che le intestazioni di colonna ListView e le colonne sono state compilate con gli elementi. Se vengono aggiunti nuovi elementi alla classe ListView, le colonne non verranno ridimensionate a meno che non viene chiamato nuovamente il metodo AutoResizeColumn.

Esempio

Nell'esempio di codice riportato di seguito viene illustrata l'inizializzazione di una classe ListView nella vista Dettagli e il ridimensionamento automatico delle colonne mediante il metodo AutoResizeColumn. Per eseguire l'esempio, incollare il codice in un Windows Form e chiamare il metodo InitializeResizingListView dal costruttore del form o dal gestore eventi Load.

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

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

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

Informazioni sulla versione

.NET Framework

Supportato in: 2.0
Vedere anche