DataGridView.AutoSizeColumnsMode Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta un valore che indica il modo in cui viene determinata la larghezza delle colonne.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { System::Windows::Forms::DataGridViewAutoSizeColumnsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnsMode value); };
public System.Windows.Forms.DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }
member this.AutoSizeColumnsMode : System.Windows.Forms.DataGridViewAutoSizeColumnsMode with get, set
Public Property AutoSizeColumnsMode As DataGridViewAutoSizeColumnsMode

Valore della proprietà

DataGridViewAutoSizeColumnsMode

Valore DataGridViewAutoSizeColumnsMode. Il valore predefinito è None.

Eccezioni

InvalidEnumArgumentException

Il valore specificato durante l'impostazione di questa proprietà non è un valore valido di DataGridViewAutoSizeColumnsMode.

InvalidOperationException

Il valore specificato durante l'impostazione di questa proprietà è ColumnHeader, le intestazioni di colonna sono nascoste e il valore della proprietà AutoSizeMode di almeno una colonna visibile è NotSet.

-oppure- Il valore specificato durante l'impostazione di questa proprietà è Fill ed è bloccata almeno una colonna visibile il cui valore della proprietà AutoSizeMode è NotSet.

Esempio

Nell'esempio di codice seguente viene illustrato come usare questa proprietà in uno scenario master/dettaglio in cui due DataGridView controlli visualizzano i dati da due tabelle in una relazione padre/figlio. In questo esempio la modalità di ridimensionamento della colonna per il controllo master è Nonee le larghezze di colonna vengono inizializzate a livello di codice per adattare i valori caricati. Il controllo dei dettagli è impostato su una modalità di ridimensionamento automatico delle colonne in modo che le colonne vengano modificate automaticamente ogni volta che i valori cambiano, ad esempio quando l'utente modifica la riga corrente nella tabella padre. Questo esempio fa parte di un esempio più ampio disponibile in Procedura: Creare un modulo master/dettaglio usando due controlli DataGridView Windows Forms.

private void Form1_Load(object sender, System.EventArgs e)
{
    // Bind the DataGridView controls to the BindingSource
    // components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource;
    detailsDataGridView.DataSource = detailsBindingSource;
    GetData();

    // Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns();

    // Configure the details DataGridView so that its columns automatically
    // adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = 
        DataGridViewAutoSizeColumnsMode.AllCells;
}

Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Load

    ' Bind the DataGridView controls to the BindingSource
    ' components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource
    detailsDataGridView.DataSource = detailsBindingSource
    GetData()

    ' Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns()

    ' Configure the details DataGridView so that its columns automatically
    ' adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = _
        DataGridViewAutoSizeColumnsMode.AllCells

End Sub

Commenti

Questa proprietà consente di configurare il controllo in modo che le larghezze di colonna vengano regolate automaticamente per riempire il controllo o per adattare il contenuto della cella. Le regolazioni delle dimensioni si verificano in modalità di riempimento ogni volta che viene modificata la larghezza del controllo. Nelle modalità di ridimensionamento basate sul contenuto, le modifiche alle dimensioni si verificano ogni volta che il contenuto della cella cambia o, se WrapMode è abilitato, ogni volta che le altezze delle righe cambiano. Alcune modalità di ridimensionamento basate su contenuto consentono di limitare la regolazione delle dimensioni alle righe attualmente visualizzate per aumentare le prestazioni.

Per modificare la modalità di ridimensionamento per una singola colonna, impostarne la AutoSizeMode proprietà. Il valore predefinito di questa proprietà è NotSet, che indica che la colonna eredita il comportamento e il InheritedAutoSizeMode relativo valore della proprietà dal controllo.

Le colonne in modalità di riempimento dividono la larghezza del controllo disponibile in proporzioni indicate dai valori delle proprietà FillWeight . La larghezza disponibile per la modalità di riempimento è determinata sottraendo le larghezze di tutte le altre colonne dalla larghezza dell'area client del controllo. Se questa larghezza è inferiore ai valori combinati MinimumWidth di tutte le colonne in modalità riempimento, viene visualizzata la barra di scorrimento orizzontale, tutte le colonne in modalità riempimento vengono visualizzate con le relative larghezze minime e il ridimensionamento della colonna utente è disabilitato. Per altre informazioni sulla modalità di riempimento delle colonne, vedere Modalità riempimento colonne nel controllo DataGridView Windows Forms.

Solo le colonne con un Visible valore di proprietà di true vengono ridimensionate automaticamente e la modifica della visibilità di una colonna non causa il ridimensionamento. Inoltre, quando le colonne vengono impostate per ridimensionare automaticamente, l'utente non può modificare le larghezze di colonna con il mouse.

Per regolare le larghezze di colonna a livello di codice, usare i AutoResizeColumn metodi o AutoResizeColumns impostare la proprietà column Width .

Per altre informazioni sul ridimensionamento automatico basato sul contenuto, vedere Opzioni di ridimensionamento nella Windows Forms Controllo DataGridView.

Si applica a

Vedi anche