DataGridView.AutoSizeRowsMode Proprietà

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.

Ottiene o imposta un valore che indica il modo in cui viene determinata l'altezza delle righe.

public:
 property System::Windows::Forms::DataGridViewAutoSizeRowsMode AutoSizeRowsMode { System::Windows::Forms::DataGridViewAutoSizeRowsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeRowsMode value); };

public System.Windows.Forms.DataGridViewAutoSizeRowsMode AutoSizeRowsMode { get; set; }

member this.AutoSizeRowsMode : System.Windows.Forms.DataGridViewAutoSizeRowsMode with get, set

Public Property AutoSizeRowsMode As DataGridViewAutoSizeRowsMode

Valore della proprietà

DataGridViewAutoSizeRowsMode

Valore di DataGridViewAutoSizeRowsMode che indica la modalità di ridimensionamento. Il valore predefinito è None.

Eccezioni

InvalidEnumArgumentException

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

InvalidOperationException

Il valore specificato durante l'impostazione di questa proprietà è AllHeaders o DisplayedHeaders e le intestazioni di riga sono nascoste.

Esempio

Nell'esempio di codice seguente viene illustrato come impostare la riga in modo che venga ridimensionata automaticamente in base al contenuto delle intestazioni di riga e a tutte le colonne. Questo esempio di codice fa parte di un esempio più ampio fornito in How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView Control.

void AutoSizeRowsMode( Object^ /*sender*/, EventArgs^ /*es*/ )
{
   dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::AllCells;
}

private void AutoSizeRowsMode(Object sender, EventArgs es)
{
    dataGridView1.AutoSizeRowsMode =
        DataGridViewAutoSizeRowsMode.AllCells;
}

Private Sub AutoSizeRowsMode(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    DataGridView1.AutoSizeRowsMode = _
        DataGridViewAutoSizeRowsMode.AllCells

End Sub

Commenti

Questa proprietà consente di configurare il controllo in modo che le altezze delle righe vengano regolate automaticamente per adattarne il contenuto ogni volta che il contenuto cambia. Se WrapMode è abilitato, anche le altezze delle righe vengono regolate ogni volta che cambiano le larghezze delle colonne. Alcune modalità di ridimensionamento consentono di limitare la regolazione delle dimensioni alle righe attualmente visualizzate per migliorare le prestazioni.

Solo le righe con un Visible valore della proprietà vengono true ridimensionate automaticamente e la modifica della visibilità di una riga non comporta l'esecuzione del ridimensionamento. Inoltre, quando le righe vengono impostate per il ridimensionamento automatico, l'utente non può regolare le altezze delle righe con il mouse.

Il Height valore di una riga ridimensionata automaticamente viene ricalcolato durante il layout per tenere conto delle dimensioni del tipo di carattere utilizzato. Per ottenere il valore corretto Height, è necessario recuperare il valore nell'evento del Layout modulo anziché nel costruttore del modulo.

Per regolare l'altezza delle righe a livello di codice, utilizzare i AutoResizeRow metodi o AutoResizeRows o impostare la proprietà row Height .

Affinché il contenuto della cella venga disposto su più righe quando viene ridimensionata una riga, lo stile della cella in vigore per la cella deve avere un WrapMode valore della proprietà .True

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

Si applica a