DataGridViewAutoSizeColumnsMode Enumerazione

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Definisce i valori che indicano il modo in cui deve essere regolata la larghezza delle colonne.

public enum class DataGridViewAutoSizeColumnsMode

public enum DataGridViewAutoSizeColumnsMode

type DataGridViewAutoSizeColumnsMode = 

Public Enum DataGridViewAutoSizeColumnsMode

Ereditarietà

Object

ValueType

Enum

DataGridViewAutoSizeColumnsMode

Campi

AllCells	6	La larghezza delle colonne viene adattata al contenuto di tutte le celle nelle colonne, comprese quelle di intestazione.
AllCellsExceptHeader	4	La larghezza delle colonne viene adattata al contenuto di tutte le celle nelle colonne, escluse quelle di intestazione.
ColumnHeader	2	La larghezza delle colonne viene adattata al contenuto delle celle delle intestazioni di colonna.
DisplayedCells	10	La larghezza delle colonne viene adattata al contenuto di tutte le celle delle colonne nelle righe attualmente visualizzate sullo schermo, comprese le celle di intestazione.
DisplayedCellsExceptHeader	8	La larghezza delle colonne viene adattata al contenuto di tutte le celle delle colonne nelle righe attualmente visualizzate sullo schermo, escluse le celle di intestazione.
Fill	16	La larghezza delle colonne viene regolata in modo che la larghezza di tutte le colonne occupi esattamente l'area di visualizzazione del controllo. La barra di scorrimento orizzontale sarà necessaria soltanto se la larghezza delle colonne è minore dei valori specificati nella proprietà MinimumWidth. La larghezza relativa delle colonne viene determinata dai valori relativi della proprietà FillWeight.
None	1	La larghezza delle colonne non viene regolata automaticamente.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questa enumerazione in uno scenario master/dettagli 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 è None e le larghezze di colonna vengono inizializzate a livello di codice per adattare i valori caricati. Il controllo dettagli è impostato su una modalità di ridimensionamento automatico 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

Il DataGridView controllo può ridimensionare le colonne per renderle disponibili nella larghezza orizzontale del controllo o per renderle visualizzate il contenuto completo di tutte le celle o delle celle specificate.

Con Fill la modalità, la larghezza preferita di una colonna è determinata dal ridimensionamento di tutte le colonne in tale modalità in modo che tutte le colonne visibili nel controllo riempia esattamente la larghezza orizzontale dell'area di visualizzazione disponibile. Con altre modalità, la larghezza della colonna preferita è la larghezza minima necessaria per visualizzare il valore di cella più grande da tutte le celle o un subset di celle in tale colonna, ad esempio il subset di celle attualmente visualizzate. L'uso di un subset di celle per determinare la nuova larghezza è utile per evitare una penalità delle prestazioni quando si usano molte righe di dati.

Il ridimensionamento automatico basato sul contenuto impedisce agli utenti di modificare le larghezze di colonna con il mouse. Il ridimensionamento dell'utente è abilitato in modalità di riempimento, tuttavia.

Questa enumerazione viene usata dalla proprietà e AutoResizeColumns dal metodo control.DataGridViewAutoSizeColumnsMode

Per altre informazioni sulle modalità di ridimensionamento, vedere Opzioni di ridimensionamento nel controllo DataGridView Windows Forms. Per altre informazioni sulla modalità di riempimento delle colonne in particolare, vedere Modalità riempimento colonna nella Windows Forms Controllo DataGridView.

Vedi anche

• DataGridView
• AutoSizeColumnsMode
• AutoSizeMode
• DataGridViewAutoSizeColumnMode
• AutoResizeColumns
• AutoResizeColumn
• Opzioni di ridimensionamento nel controllo DataGridView Windows Form
• Modalità di riempimento di colonna nel controllo DataGridView Windows Form