DataGridViewAutoSizeColumnMode Enumerazione

Definizione

Definisce i valori per specificare la modalità di regolazione della larghezza di una colonna.

public enum class DataGridViewAutoSizeColumnMode
public enum DataGridViewAutoSizeColumnMode
type DataGridViewAutoSizeColumnMode = 
Public Enum DataGridViewAutoSizeColumnMode
Ereditarietà
DataGridViewAutoSizeColumnMode

Campi

Nome Valore Descrizione
NotSet 0

Il comportamento di ridimensionamento della colonna viene ereditato dalla AutoSizeColumnsMode proprietà .

None 1

La larghezza della colonna non viene modificata automaticamente.

ColumnHeader 2

La larghezza della colonna viene modificata in base al contenuto della cella dell'intestazione di colonna.

AllCellsExceptHeader 4

La larghezza della colonna viene adattata in base al contenuto di tutte le celle della colonna, esclusa la cella di intestazione.

AllCells 6

La larghezza della colonna viene modificata in base al contenuto di tutte le celle della colonna, inclusa la cella di intestazione.

DisplayedCellsExceptHeader 8

La larghezza della colonna viene adattata in base al contenuto di tutte le celle della colonna che si trovano in righe attualmente visualizzate sullo schermo, escluse la cella di intestazione.

DisplayedCells 10

La larghezza della colonna viene adattata in base al contenuto di tutte le celle della colonna che si trovano in righe attualmente visualizzate sullo schermo, inclusa la cella di intestazione.

Fill 16

La larghezza della colonna viene modificata in modo che le larghezze di tutte le colonne riempia esattamente l'area di visualizzazione del controllo, richiedendo lo scorrimento orizzontale solo per mantenere le larghezze delle colonne sopra i valori delle MinimumWidth proprietà. Le larghezze relative delle colonne sono determinate dai valori delle proprietà relative FillWeight .

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questa enumerazione per configurare una colonna a larghezza fissa. Questo esempio fa parte di un esempio più ampio disponibile in Procedura: Impostare le modalità di ridimensionamento del controllo DataGridView di Windows Form.

DataGridViewTextBoxColumn idColumn =
    new DataGridViewTextBoxColumn();
idColumn.HeaderText = "ID";
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None;
idColumn.Resizable = DataGridViewTriState.False;
idColumn.ReadOnly = true;
idColumn.Width = 20;
Dim idColumn As New DataGridViewTextBoxColumn()
idColumn.HeaderText = "ID"
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None
idColumn.Resizable = DataGridViewTriState.False
idColumn.ReadOnly = True
idColumn.Width = 20

Commenti

Il DataGridView controllo può ridimensionare le colonne per renderle riempie la larghezza orizzontale disponibile del controllo o per renderle visualizzate il contenuto completo di tutte le celle o di celle specificate.

Con la modalità Riempimento, la larghezza preferita di una colonna viene determinata ridimensionando tutte le colonne in tale modalità in modo che tutte le colonne visibili nel controllo riempino 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 di 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 riduzione delle prestazioni quando si usano molte righe di dati.

Il ridimensionamento automatico basato sul contenuto impedisce agli utenti di regolare la larghezza delle colonne con il mouse. Il ridimensionamento dell'utente è tuttavia abilitato in modalità di riempimento.

Questa enumerazione viene utilizzata dalle AutoSizeMode proprietà e InheritedAutoSizeMode delle colonne e dal DataGridView.AutoResizeColumn metodo .

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

Si applica a

Vedi anche