DataGridView.AutoResizeColumnHeadersHeight Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Passt die Höhe der Spaltenheader an den Headerinhalt an.

Überlädt

AutoResizeColumnHeadersHeight(Int32, Boolean, Boolean)

Passt die Höhe der Spaltenheader auf Grundlage der Inhaltsänderungen der Header in der angegebenen Spalte an. Optional wird die Höhe mit der Annahme berechnet, dass anschließend die jeweilige Breite der Spalten- und/oder Zeilenheader angepasst wird.
AutoResizeColumnHeadersHeight(Boolean, Boolean)

Passt die Höhe der Spaltenheader an den Inhalt an. Optional wird die Höhe mit der Annahme berechnet, dass anschließend die jeweilige Breite der Spalten- und/oder Zeilenheader angepasst wird.
AutoResizeColumnHeadersHeight()

Passt die Höhe der Spaltenheader an den Inhalt des größten Spaltenheaders an.
AutoResizeColumnHeadersHeight(Int32)

Passt die Höhe der Spaltenheader auf Grundlage von Inhaltsänderungen an den Header in der angegebenen Spalte an.

AutoResizeColumnHeadersHeight(Int32, Boolean, Boolean)

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

protected:
 void AutoResizeColumnHeadersHeight(int columnIndex, bool fixedRowHeadersWidth, bool fixedColumnWidth);
protected void AutoResizeColumnHeadersHeight (int columnIndex, bool fixedRowHeadersWidth, bool fixedColumnWidth);
member this.AutoResizeColumnHeadersHeight : int * bool * bool -> unit
Protected Sub AutoResizeColumnHeadersHeight (columnIndex As Integer, fixedRowHeadersWidth As Boolean, fixedColumnWidth As Boolean)

Parameter

columnIndex
Int32

Der Index des Spaltenheaders, mit dessen Inhalt die neue Höhe bestimmt werden soll.

fixedRowHeadersWidth
Boolean

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

fixedColumnWidth
Boolean

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

Ausnahmen

ArgumentOutOfRangeException

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

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann die Größe der Spaltenüberschriften geändert wird, wenn sich nur der Inhalt des Headers in der angegebenen Spalte aufgrund von Benutzerbearbeitungen oder Änderungen an einer gebundenen Datenquelle geändert hat. Die Höhe der Spaltenüberschriften wird nur einmal pro Methodenaufruf angepasst, wenn dies für die Inhaltsänderung erforderlich ist. Wenn sich der Inhalt der Spaltenüberschriften später ändert, werden die Spaltenüberschriften nicht automatisch angepasst. Verwenden Sie die -Eigenschaft, um die Spaltenüberschriften so festzulegen, dass die Größe automatisch geändert wird, wenn sich ihr ColumnHeadersHeightSizeMode Inhalt ändert.

Damit Zellinhalte in mehrere Zeilen umgebrochen werden können, wenn die Größe der Spaltenüberschriften geändert wird, muss die für die Zelle wirksamen Zellenformat den WrapMode -Eigenschaftswert aufweisen True.

Diese Überladung ist geschützt und ist so konzipiert, dass Sie in einer abgeleiteten DataGridView Klasse ideale Zellenhöhen-Breite-Verhältnisse erzielen können. Wenn die fixedColumnWidth Parameter falseoder fixedRowHeadersWidth sind, wird die Höhe der Spaltenüberschriften mit der Erwartung berechnet, dass Sie die Methoden wie AutoResizeColumns und AutoResizeRowHeadersWidth als Nächstes aufrufen.

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

Weitere Informationen

Gilt für:

AutoResizeColumnHeadersHeight(Boolean, Boolean)

Passt die Höhe der Spaltenheader an den Inhalt an. Optional wird die Höhe mit der Annahme berechnet, dass anschließend die jeweilige Breite der Spalten- und/oder Zeilenheader angepasst wird.

protected:
 void AutoResizeColumnHeadersHeight(bool fixedRowHeadersWidth, bool fixedColumnsWidth);
protected void AutoResizeColumnHeadersHeight (bool fixedRowHeadersWidth, bool fixedColumnsWidth);
member this.AutoResizeColumnHeadersHeight : bool * bool -> unit
Protected Sub AutoResizeColumnHeadersHeight (fixedRowHeadersWidth As Boolean, fixedColumnsWidth As Boolean)

Parameter

fixedRowHeadersWidth
Boolean

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

fixedColumnsWidth
Boolean

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

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann sich die Größe der Spaltenüberschriften ändert. Die Höhe der Spaltenüberschriften wird nur einmal pro Methodenaufruf angepasst. Wenn sich der Inhalt der Spaltenüberschriften später ändert, werden die Spaltenüberschriften nicht automatisch angepasst. Verwenden Sie die -Eigenschaft, um die Spaltenüberschriften so festzulegen, dass die Größe automatisch geändert wird, wenn sich ihr ColumnHeadersHeightSizeMode Inhalt ändert.

Damit Zellinhalte in mehrere Zeilen umgebrochen werden können, wenn die Größe der Spaltenüberschriften geändert wird, muss die für die Zelle wirksamen Zellenformat den WrapMode -Eigenschaftswert aufweisen True.

Diese Überladung ist geschützt und ist so konzipiert, dass Sie in einer abgeleiteten DataGridView Klasse ideale Zellenhöhen-Breite-Verhältnisse erzielen können. Wenn die fixedColumnsWidth Parameter falseoder fixedRowHeadersWidth sind, wird die Höhe der Spaltenüberschriften mit der Erwartung berechnet, dass Sie die Methoden wie AutoResizeColumns und AutoResizeRowHeadersWidth als Nächstes aufrufen.

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

Weitere Informationen

Gilt für:

AutoResizeColumnHeadersHeight()

Passt die Höhe der Spaltenheader an den Inhalt des größten Spaltenheaders an.

public:
 void AutoResizeColumnHeadersHeight();
public void AutoResizeColumnHeadersHeight ();
member this.AutoResizeColumnHeadersHeight : unit -> unit
Public Sub AutoResizeColumnHeadersHeight ()

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Größe von Spaltenüberschriften und Zeilen als Ergebnis eines Schaltflächenklicks geändert wird.

void Button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   // Resize the height of the column headers. 
   dataGridView1->AutoResizeColumnHeadersHeight();

   // Resize all the row heights to fit the contents of all non-header cells.
   dataGridView1->AutoResizeRows(
         DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}

private void button1_Click(object sender, System.EventArgs e)
{
    // Resize the height of the column headers. 
    dataGridView1.AutoResizeColumnHeadersHeight();

    // Resize all the row heights to fit the contents of all non-header cells.
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}

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

    ' Resize the height of the column headers. 
    dataGridView1.AutoResizeColumnHeadersHeight()

    ' Resize all the row heights to fit the contents of all 
    ' non-header cells.
    dataGridView1.AutoResizeRows( _
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann sich die Größe der Spaltenüberschriften ändert. Die Höhe der Spaltenüberschriften wird nur einmal pro Methodenaufruf angepasst. Wenn sich der Inhalt der Spaltenüberschriften später ändert, werden die Spaltenüberschriften nicht automatisch angepasst. Verwenden Sie die -Eigenschaft, um die Spaltenüberschriften so festzulegen, dass die Größe automatisch geändert wird, wenn sich ihr ColumnHeadersHeightSizeMode Inhalt ändert.

Damit Zellinhalte in mehrere Zeilen umgebrochen werden können, wenn die Größe der Spaltenüberschriften geändert wird, muss die für die Zelle wirksamen Zellenformat den WrapMode -Eigenschaftswert aufweisen True.

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

Weitere Informationen

Gilt für:

AutoResizeColumnHeadersHeight(Int32)

Passt die Höhe der Spaltenheader auf Grundlage von Inhaltsänderungen an den Header in der angegebenen Spalte an.

public:
 void AutoResizeColumnHeadersHeight(int columnIndex);
public void AutoResizeColumnHeadersHeight (int columnIndex);
member this.AutoResizeColumnHeadersHeight : int -> unit
Public Sub AutoResizeColumnHeadersHeight (columnIndex As Integer)

Parameter

columnIndex
Int32

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

Ausnahmen

ArgumentOutOfRangeException

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

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann die Größe der Spaltenüberschriften geändert wird, wenn sich nur der Inhalt des Headers in der angegebenen Spalte aufgrund von Benutzerbearbeitungen oder Änderungen an einer gebundenen Datenquelle geändert hat. Die Höhe der Spaltenüberschriften wird nur einmal pro Methodenaufruf angepasst, wenn dies für die Inhaltsänderung erforderlich ist. Wenn sich der Inhalt der Spaltenüberschriften später ändert, werden die Spaltenüberschriften nicht automatisch angepasst. Verwenden Sie die -Eigenschaft, um die Spaltenüberschriften so festzulegen, dass die Größe automatisch geändert wird, wenn sich ihr ColumnHeadersHeightSizeMode Inhalt ändert.

Damit Zellinhalte in mehrere Zeilen umgebrochen werden können, wenn die Größe der Spaltenüberschriften geändert wird, muss die für die Zelle wirksamen Zellenformat den WrapMode -Eigenschaftswert aufweisen True.

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

Weitere Informationen

Gilt für: