DataGridView.AutoResizeColumns Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Passt die Breite aller Spalten an den Inhalt ihrer Zellen an.
Überlädt
AutoResizeColumns() |
Passt die Breite aller Spalten an den Inhalt ihrer Zellen einschließlich der Headerzellen an. |
AutoResizeColumns(DataGridViewAutoSizeColumnsMode) |
Passt die Breite aller Spalten im angegebenen Größenmodus an. |
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean) |
Passt die Breite aller Spalten im angegebenen Größenänderungsmodus an und berechnet optional die jeweilige Breite unter der Annahme, dass die jeweilige Zeilenhöhe anschließend angepasst wird. |
AutoResizeColumns()
Passt die Breite aller Spalten an den Inhalt ihrer Zellen einschließlich der Headerzellen an.
public:
void AutoResizeColumns();
public void AutoResizeColumns ();
member this.AutoResizeColumns : unit -> unit
Public Sub AutoResizeColumns ()
Beispiele
Im folgenden Codebeispiel werden alle Spalten so angepasst, dass sie an den Inhalt der Spalten und die Spaltenüberschriften angepasst werden. Dieses Codebeispiel ist Teil eines größeren Beispiels, das in How to: Programmgesteuertes Ändern der Größe von Zellen zum Anpassen von Inhalten im Windows Forms DataGridView-Steuerelement bereitgestellt wird.
void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
dataGridView1.AutoResizeColumns(
DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)
End Sub
Hinweise
Diese Methode ist nützlich, wenn Sie steuern möchten, wann Spalten die Größe ändern. Die Spaltenbreiten werden nur einmal pro Methodenaufruf angepasst; Wenn sich der Inhalt der Spalten später ändert, werden die Spalten nicht automatisch angepasst. Verwenden Sie die Methode, um die AutoResizeColumn Größe einer bestimmten Spalte zu ändern. Verwenden Sie die Eigenschaft oder die AutoSizeColumnsMode Spalteneigenschaft AutoSizeMode , um die Größe automatisch zu ändern, wenn sich der Inhalt ändert.
Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter Sizing Options in the Windows Forms DataGridView Control.
Siehe auch
Gilt für
AutoResizeColumns(DataGridViewAutoSizeColumnsMode)
Passt die Breite aller Spalten im angegebenen Größenmodus an.
public:
void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
public void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode -> unit
Public Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode)
Parameter
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
Einer der DataGridViewAutoSizeColumnsMode-Werte.
Ausnahmen
autoSizeColumnsMode
hat den Wert ColumnHeader, und ColumnHeadersVisible ist false
.
autoSizeColumnsMode
ist kein gültiger DataGridViewAutoSizeColumnsMode-Wert.
Beispiele
Im folgenden Codebeispiel werden alle Spalten so angepasst, dass sie an den Inhalt der Spalten und die Spaltenüberschriften angepasst werden. Dieses Codebeispiel ist Teil eines größeren Beispiels, das in How to: Programmgesteuertes Ändern der Größe von Zellen zum Anpassen von Inhalten im Windows Forms DataGridView-Steuerelement bereitgestellt wird.
void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
dataGridView1.AutoResizeColumns(
DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)
End Sub
Hinweise
Diese Methode ist nützlich, wenn Sie steuern möchten, wann Spalten die Größe ändern. Die Spaltenbreiten werden nur einmal pro Methodenaufruf angepasst; Wenn sich der Inhalt der Spalten später ändert, werden die Spalten nicht automatisch angepasst. Verwenden Sie die Methode, um die AutoResizeColumn Größe einer bestimmten Spalte zu ändern. Verwenden Sie die Eigenschaft oder die AutoSizeColumnsMode Spalteneigenschaft AutoSizeMode , um die Größe automatisch zu ändern, wenn sich der Inhalt ändert.
Mit dieser Überladung können Sie einen Größenmodus angeben, der die neuen Breiten basierend auf Werten in einer begrenzten Gruppe von Zellen berechnet, z. B. nur in angezeigten Zeilen. Dadurch wird die Leistung verbessert, wenn das Steuerelement eine große Anzahl von Zeilen enthält.
Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter Sizing Options in the Windows Forms DataGridView Control.
Siehe auch
Gilt für
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)
Passt die Breite aller Spalten im angegebenen Größenänderungsmodus an und berechnet optional die jeweilige Breite unter der Annahme, dass die jeweilige Zeilenhöhe anschließend angepasst wird.
protected:
void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
protected void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode * bool -> unit
Protected Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode, fixedHeight As Boolean)
Parameter
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
Einer der DataGridViewAutoSizeColumnsMode-Werte.
- fixedHeight
- Boolean
true
, um die jeweils neue Breite auf Grundlage der aktuellen Zeilenhöhe zu berechnen, false
, um die Breite unter der Annahme zu berechnen, dass die jeweilige Zeilenhöhe ebenfalls angepasst wird.
Ausnahmen
autoSizeColumnsMode
hat den Wert ColumnHeader, und ColumnHeadersVisible ist false
.
autoSizeColumnsMode
ist kein gültiger DataGridViewAutoSizeColumnsMode-Wert.
Hinweise
Diese Methode ist nützlich, wenn Sie steuern möchten, wann Spalten die Größe ändern. Die Spaltenbreiten werden nur einmal pro Methodenaufruf angepasst; Wenn sich der Inhalt der Spalten später ändert, werden die Spalten nicht automatisch angepasst. Verwenden Sie die Methode, um die AutoResizeColumn Größe einer bestimmten Spalte zu ändern. Verwenden Sie die Eigenschaft oder die AutoSizeColumnsMode Spalteneigenschaft AutoSizeMode , um die Größe automatisch zu ändern, wenn sich der Inhalt ändert.
Mit dieser Überladung können Sie einen Größenmodus angeben, der die neuen Breiten basierend auf Werten in einer begrenzten Gruppe von Zellen berechnet, z. B. nur in angezeigten Zeilen. Dadurch wird die Leistung verbessert, wenn das Steuerelement eine große Anzahl von Zeilen enthält.
Diese Überladung ist geschützt und ist so konzipiert, dass Sie ideale Zellhöhen-zu-Breite-Verhältnis in einer abgeleiteten DataGridView Klasse erzielen können. Wenn fixedHeight
ja false
, werden die Spaltenbreiten mit der Erwartung berechnet, dass Sie die AutoResizeRow Methode AutoResizeRows als nächstes aufrufen.
Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter Sizing Options in the Windows Forms DataGridView Control.