DataGridView.AutoSizeRowsMode Eigenschaft
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.
Ruft einen Wert ab, der angibt, wie die Zeilenhöhe bestimmt wird, oder legt ihn fest.
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
Eigenschaftswert
Ein DataGridViewAutoSizeRowsMode-Wert, der den Größenanpassungsmodus angibt. Der Standardwert ist None.
Ausnahmen
Der beim Festlegen dieser Eigenschaft angegebene Wert ist kein gültiger DataGridViewAutoSizeRowsMode-Wert.
Der beim Festlegen dieser Eigenschaft angegebene Wert ist AllHeaders oder DisplayedHeaders, wenn Zeilenheader ausgeblendet sind.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Die Zeilengröße basierend auf dem Inhalt der Zeilenheader und aller Spalten automatisch geändert wird. Dieses Codebeispiel ist Teil eines größeren Beispiels in How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView-Steuerelement.
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
Hinweise
Mit dieser Eigenschaft können Sie das Steuerelement so konfigurieren, dass Zeilenhöhen automatisch an ihren Inhalt angepasst werden, wenn sich der Inhalt ändert. Wenn WrapMode aktiviert ist, werden zeilenhöhen ebenfalls angepasst, wenn sich die Spaltenbreite ändert. Mit einigen Größenmodi können Sie die Größenanpassung auf die aktuell angezeigten Zeilen beschränken, um die Leistung zu erhöhen.
Nur Zeilen mit dem Visible Eigenschaftswert von true
werden automatisch geändert, und das Ändern der Sichtbarkeit einer Zeile führt nicht dazu, dass die Größe geändert wird. Wenn Zeilen auf automatische Größenänderung festgelegt sind, kann der Benutzer die Zeilenhöhen nicht mit der Maus anpassen.
Der Height Wert einer Zeile mit automatischer Größe wird während des Layouts neu berechnet, um die Größe der verwendeten Schriftart zu berücksichtigen. Um die richtige Heightabzurufen, sollten Sie den Wert im Ereignis des Formulars Layout und nicht im Konstruktor des Formulars abrufen.
Verwenden Sie zum programmgesteuerten Anpassen von Zeilenhöhen die AutoResizeRow -Methode oder AutoResizeRows oder legen Sie die zeileneigenschaft Height fest.
Damit Zellinhalte in mehrere Zeilen umschließen können, wenn die Größe einer Zeile geändert wird, muss die für die Zelle wirksamen Zellenformat den WrapMode Eigenschaftswert aufweisen True.
Weitere Informationen zur inhaltsbasierten automatischen Größenanpassung finden Sie unter Größenanpassungsoptionen im Windows Forms DataGridView-Steuerelement.