DataGridViewColumn.AutoSizeMode Proprietà

  • Riferimento

Definizione

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

Ottiene o imposta la modalità usata per la regolazione automatica della larghezza della colonna.

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

Valore della proprietà

DataGridViewAutoSizeColumnMode

Valore DataGridViewAutoSizeColumnMode che determina se la colonna regolerà automaticamente la propria larghezza e il modo in cui determinerà la larghezza preferita. Il valore predefinito è NotSet.

Eccezioni

InvalidEnumArgumentException

Il valore specificato al momento dell'impostazione della proprietà non è un valore DataGridViewAutoSizeColumnMode valido.

InvalidOperationException

Il valore specificato al momento dell'impostazione di questa proprietà risulta in un valore InheritedAutoSizeMode del controllo ColumnHeader per una colonna visibile se le intestazioni di colonna sono nascoste.

-oppure-

Il valore specificato al momento dell'impostazione di questa proprietà risulta in un valore InheritedAutoSizeMode del controllo Fill per una colonna visibile bloccata.

Esempio

Nell'esempio di codice seguente una colonna viene ridimensionata automaticamente in modo da adattarne la larghezza. Questo esempio di codice fa parte di un esempio più ampio fornito per la DataGridViewColumn classe .

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}

// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}

' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

Commenti

Il comportamento di ridimensionamento automatico della colonna è determinato dal valore della InheritedAutoSizeMode proprietà , che corrisponde al valore della AutoSizeMode proprietà per tutti i valori tranne NotSet, che indica che il valore viene ereditato dalla DataGridView.AutoSizeColumnsMode proprietà .

Quando il valore della InheritedAutoSizeMode proprietà è Fill, la colonna viene ridimensionata insieme ad altre colonne in tale modalità. Tutte le colonne in modalità riempimento nel controllo dividono lo spazio disponibile in proporzioni determinate 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 la larghezza minima e il ridimensionamento delle colonne dell'utente è disabilitato. Per altre informazioni sulla modalità di riempimento delle colonne, vedere Modalità riempimento colonna nel controllo DataGridView Windows Forms.

Quando la InheritedAutoSizeMode proprietà è impostata su qualsiasi altro valore, ad eccezione Nonedi , la colonna gestirà la larghezza in modo che i relativi valori di cella vengano visualizzati completamente senza ritaglio. Nelle modalità di ridimensionamento basato sul contenuto, le modifiche alle dimensioni si verificano ogni volta che il contenuto della cella cambia o, se WrapMode è abilitato, ogni volta che l'altezza delle righe cambia. Alcune modalità di ridimensionamento basate sul contenuto consentono di limitare la regolazione delle dimensioni alle righe attualmente visualizzate per migliorare le prestazioni.

Vengono ridimensionate solo le colonne con un Visible valore della true proprietà e la modifica della visibilità di una colonna non comporta l'esecuzione del ridimensionamento. Inoltre, quando le colonne vengono impostate per il ridimensionamento automatico, l'utente non può modificare la larghezza delle colonne con il mouse.

Per regolare la larghezza delle colonne a livello di AutoResizeColumn codice, utilizzare i metodi o AutoResizeColumns il DataGridView controllo o impostare la proprietà della colonnaWidth.

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

Si applica a

Vedi anche