DataGridView.AutoResizeRowHeadersWidth Methode

Definition

Passt die Breite der Zeilenheader an den Headerinhalt an.

Überlädt

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

Passt die Breite der Zeilenheader anhand des angegebenen Größenmodus an.

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)

Passt die Breite der Zeilenheader auf Grundlage der Inhaltsänderungen in der angegebenen Zeile im angegebenen Größenänderungsmodus an.

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Passt die Breite der angegebenen Zeilenheader im angegebenen Größenänderungsmodus an und berechnet optional die Breite unter der Annahme, dass die jeweilige Zeilen- und/oder Spaltenheaderbreite anschließend angepasst wird.

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Passt die Breite der Zeilenheader auf Grundlage der Inhaltsänderungen der Header in der angegebenen Spalte im angegebenen Größenmodus an. Optional wird die Breite mit der Annahme berechnet, dass anschließend die jeweilige Breite der Spalten- und/oder Zeilenheader angepasst wird.

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

Passt die Breite der Zeilenheader anhand des angegebenen Größenmodus an.

public:
 void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)

Parameter

Ausnahmen

rowHeadersWidthSizeMode hat den Wert EnableResizing oder DisableResizing.

rowHeadersWidthSizeMode ist kein gültiger DataGridViewRowHeadersWidthSizeMode-Wert.

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann die Zeilenüberschriften die Größe ändern. Die Breite der Zeilenüberschriften wird nur einmal pro Methodenaufruf angepasst; wenn sich der Inhalt der Zeilenüberschriften später ändert, werden die Zeilenüberschriften nicht automatisch angepasst. Verwenden Sie RowHeadersWidthSizeMode die Eigenschaft, um die Zeilenüberschriften automatisch zu ändern, wenn der Inhalt geändert wird.

Mit dieser Methode können Sie einen Größenmodus angeben, der die neue Breite basierend auf Werten in einer begrenzten Gruppe von Kopfzeilen 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 "Größenoptionen" im Windows Forms DataGridView-Steuerelement.

Siehe auch

Gilt für

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)

Passt die Breite der Zeilenheader auf Grundlage der Inhaltsänderungen in der angegebenen Zeile im angegebenen Größenänderungsmodus an.

public:
 void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)

Parameter

rowIndex
Int32

Der Index des Zeilenheaders mit dem geänderten Inhalt.

Ausnahmen

rowIndex liegt nicht im gültigen Bereich von 0 bis zur Anzahl der Zeilen minus 1.

rowHeadersWidthSizeMode hat den Wert EnableResizing oder DisableResizing.

rowHeadersWidthSizeMode ist kein gültiger DataGridViewRowHeadersWidthSizeMode-Wert.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Größe der Zeilenkopfbreite basierend auf Änderungen an den Inhalten der ersten Zeilenüberschrift geändert wird. 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 SizeFirstRowHeaderToAllHeaders( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRowHeadersWidth(0, DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders);
}
private void SizeFirstRowHeaderToAllHeaders(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRowHeadersWidth(
        0, DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}
Private Sub SizeFirstRowHeaderToAllHeaders(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    DataGridView1.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)

End Sub

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann die Zeilenüberschriften die Größe ändern möchten, wenn nur der Inhalt der Kopfzeile in der angegebenen Zeile aufgrund von Benutzerbearbeitungen oder Änderungen an einer gebundenen Datenquelle geändert wurde. Die Breite der Zeilenheader wird nur einmal pro Methodeaufruf angepasst, wenn die Inhaltsänderung erforderlich ist; wenn sich der Inhalt der Zeilenüberschriften später ändert, werden die Zeilenüberschriften nicht automatisch angepasst. Verwenden Sie RowHeadersWidthSizeMode die Eigenschaft, um die Zeilenüberschriften automatisch zu ändern, wenn der Inhalt geändert wird.

Mit dieser Methode können Sie einen Größenmodus angeben, der die neue Breite basierend auf Werten in einer begrenzten Gruppe von Kopfzeilen 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 "Größenoptionen" im Windows Forms DataGridView-Steuerelement.

Siehe auch

Gilt für

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Passt die Breite der angegebenen Zeilenheader im angegebenen Größenänderungsmodus an und berechnet optional die Breite unter der Annahme, dass die jeweilige Zeilen- und/oder Spaltenheaderbreite anschließend angepasst wird.

protected:
 void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
protected void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowsHeight As Boolean)

Parameter

fixedColumnHeadersHeight
Boolean

true, um die neue Breite auf Grundlage der aktuellen Höhe der angegebenen Spalte zu berechnen, false, um die Breite unter der Annahme zu berechnen, dass die Höhe der Spaltenheader ebenfalls angepasst wird.

fixedRowsHeight
Boolean

true, um die neue Breite auf Grundlage der aktuellen Zeilenhöhe zu berechnen, false, um die Breite unter der Annahme zu berechnen, dass die Zeilenhöhe ebenfalls angepasst wird.

Ausnahmen

rowHeadersWidthSizeMode hat den Wert EnableResizing oder DisableResizing.

rowHeadersWidthSizeMode ist kein gültiger DataGridViewRowHeadersWidthSizeMode-Wert.

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann die Zeilenüberschriften die Größe ändern. Die Breite der Zeilenüberschriften wird nur einmal pro Methodenaufruf angepasst; wenn sich der Inhalt der Zeilenüberschriften später ändert, werden die Zeilenüberschriften nicht automatisch angepasst. Verwenden Sie RowHeadersWidthSizeMode die Eigenschaft, um die Zeilenüberschriften automatisch zu ändern, wenn der Inhalt geändert wird.

Mit dieser Methode können Sie einen Größenmodus angeben, der die neue Breite basierend auf Werten in einer begrenzten Gruppe von Kopfzeilen 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 optimale Zellhöhen- und Breiteverhältnisse in einer abgeleiteten DataGridView Klasse erreichen können. Wenn dies fixedRowsHeight fixedColumnHeadersHeight der Parameter istfalse, wird die Breite der Zeilenüberschriften mit der Erwartung berechnet, dass Sie Methoden AutoResizeRows wie z. B. und AutoResizeColumnHeadersHeight nächste aufrufen.

Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter "Größenoptionen" im Windows Forms DataGridView-Steuerelement.

Siehe auch

Gilt für

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Passt die Breite der Zeilenheader auf Grundlage der Inhaltsänderungen der Header in der angegebenen Spalte im angegebenen Größenmodus an. Optional wird die Breite mit der Annahme berechnet, dass anschließend die jeweilige Breite der Spalten- und/oder Zeilenheader angepasst wird.

protected:
 void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
protected void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowHeight As Boolean)

Parameter

rowIndex
Int32

Der Index der Zeile, die den Header mit dem geänderten Inhalt enthält.

fixedColumnHeadersHeight
Boolean

true, um die neue Breite auf Grundlage der aktuellen Höhe der angegebenen Spalte zu berechnen, false, um die Breite unter der Annahme zu berechnen, dass die Höhe der Spaltenheader ebenfalls angepasst wird.

fixedRowHeight
Boolean

true, um die neue Breite auf Grundlage der aktuellen Höhe der angegebenen Zeile zu berechnen, false, um die Breite unter der Annahme zu berechnen, dass die Zeilenhöhe ebenfalls angepasst wird.

Ausnahmen

rowIndex liegt nicht im gültigen Bereich von 0 bis zur Anzahl der Zeilen minus 1.

rowHeadersWidthSizeMode hat den Wert EnableResizing oder DisableResizing.

rowHeadersWidthSizeMode ist kein gültiger DataGridViewRowHeadersWidthSizeMode-Wert.

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann die Zeilenüberschriften die Größe ändern möchten, wenn nur der Inhalt der Kopfzeile in der angegebenen Zeile aufgrund von Benutzerbearbeitungen oder Änderungen an einer gebundenen Datenquelle geändert wurde. Die Breite der Zeilenheader wird nur einmal pro Methodeaufruf angepasst, wenn die Inhaltsänderung erforderlich ist; wenn sich der Inhalt der Zeilenüberschriften später ändert, werden die Zeilenüberschriften nicht automatisch angepasst. Verwenden Sie RowHeadersWidthSizeMode die Eigenschaft, um die Zeilenüberschriften automatisch zu ändern, wenn der Inhalt geändert wird.

Mit dieser Methode können Sie einen Größenmodus angeben, der die neue Breite basierend auf Werten in einer begrenzten Gruppe von Kopfzeilen 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 optimale Zellhöhen- und Breiteverhältnisse in einer abgeleiteten DataGridView Klasse erreichen können. Wenn dies fixedRowHeight fixedColumnHeadersHeight der Parameter istfalse, wird die Breite der Zeilenüberschriften mit der Erwartung berechnet, dass Sie Methoden AutoResizeRows wie z. B. und AutoResizeColumnHeadersHeight nächste aufrufen.

Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter "Größenoptionen" im Windows Forms DataGridView-Steuerelement.

Siehe auch

Gilt für