DataGridViewAutoSizeColumnMode Enumerazione

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

public enum class DataGridViewAutoSizeColumnMode

public enum DataGridViewAutoSizeColumnMode

type DataGridViewAutoSizeColumnMode =

Public Enum DataGridViewAutoSizeColumnMode

Ereditarietà: Object

ValueType

Enum
DataGridViewAutoSizeColumnMode

Campi

AllCells	6	La larghezza della colonna viene modificata in base a quella del contenuto di tutte le relative celle, inclusa la cella dell'intestazione.
AllCellsExceptHeader	4	La larghezza della colonna viene modificata in base a quella del contenuto di tutte le relative celle, esclusa la cella dell'intestazione.
ColumnHeader	2	La larghezza della colonna viene modificata in base a quella del contenuto della cella dell'intestazione.
DisplayedCells	10	La larghezza della colonna viene modificata in base a quella del contenuto di tutte le relative celle presenti nelle righe correntemente visualizzate, inclusa la cella dell'intestazione.
DisplayedCellsExceptHeader	8	La larghezza della colonna viene modificata in base a quella del contenuto di tutte le relative celle presenti nelle righe correntemente visualizzate, esclusa la cella dell'intestazione.
Fill	16	La larghezza della colonna viene modificata in modo che tutte le colonne occupino l'intera area di visualizzazione del controllo. Sarà pertanto necessario scorrere l'area in orizzontale solo per mantenere la larghezza delle colonne al di sopra dei valori della proprietà MinimumWidth. La larghezza relativa delle colonne viene determinata dai valori relativi della proprietà FillWeight.
None	1	La modifica della larghezza delle colonne non è automatica.
NotSet	0	Il comportamento di ridimensionamento della colonna viene ereditato dalla proprietà AutoSizeColumnsMode.

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 Windows Forms.

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 in grado di riempire la larghezza orizzontale disponibile del controllo o di visualizzare il contenuto completo di tutte le celle o delle celle specificate.

Con la modalità riempimento, 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 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 sottoinsieme di celle in tale colonna, ad esempio il subset di celle presenti nelle righe 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 Windows Forms. Per altre informazioni sulla modalità di riempimento delle colonne in particolare, vedere Modalità riempimento colonna nel controllo DataGridView Windows Forms.

Si applica a