DataGridViewColumn.AutoSizeMode-Eigenschaft

public DataGridViewAutoSizeColumnMode AutoSizeMode { get; set; }

/** @property */
public DataGridViewAutoSizeColumnMode get_AutoSizeMode ()

/** @property */
public void set_AutoSizeMode (DataGridViewAutoSizeColumnMode value)

public function get AutoSizeMode () : DataGridViewAutoSizeColumnMode

public function set AutoSizeMode (value : DataGridViewAutoSizeColumnMode)

Nicht zutreffend.

Eigenschaftenwert

Das Verhalten der automatischen Größenänderung der Spalte wird durch den Wert der InheritedAutoSizeMode-Eigenschaft bestimmt, der mit dem Wert der AutoSizeMode-Eigenschaft für alle Werte außer NotSet übereinstimmt. Dies weist darauf hin, dass der Wert stattdessen von der DataGridView.AutoSizeColumnsMode-Eigenschaft geerbt wird.

Wenn der InheritedAutoSizeMode-Eigenschaftenwert Fill ist, wird die Größe der Spalte zusammen mit anderen Spalten in diesem Modus geändert. Alle im Steuerelement vorhandenen Spalten im Füllmodus teilen den verfügbaren Platz in Abschnitte, die von ihren FillWeight-Eigenschaftenwerten bestimmt werden. Die für den Füllmodus verfügbare Breite wird durch Subtrahieren der Breite aller Spalten von der Breite des Clientbereichs des Steuerelements bestimmt. Wenn die Breite geringer ist, als die Summe der MinimumWidth-Werte aller Spalten im Füllmodus, wird die horizontale Bildlaufleiste angezeigt, alle Spalten im Füllmodus werden mit der Mindestbreite angezeigt, und die Größenänderung der Spalten durch den Benutzer wird deaktiviert. Weitere Informationen zum Spaltenfüllmodus finden Sie unter Spaltenfüllmodus im DataGridView-Steuerelement in Windows Forms.

Wenn die InheritedAutoSizeMode-Eigenschaft auf einen anderen Wert außer None festgelegt ist, verwaltet die Spalte ihre Breite, sodass ihre Zellwerte vollständig angezeigt werden, ohne abgeschnitten zu sein. In inhaltsbasierten Modi erfolgen Größenanpassungen, wenn sich der Inhalt der Zelle ändert oder (wenn WrapMode aktiviert ist) wenn sich die Höhe von Zeilen ändert. In einigen inhaltsbasierten Größenanpassungsmodi können Sie die Größenanpassung auf die gerade angezeigten Zeilen beschränken, um die Leistung zu verbessern.

Nur die Größe von Spalten mit dem Visible-Eigenschaftenwert true wird angepasst. Durch das Ändern der Sichtbarkeit einer Spalte wird deren Größe nicht geändert. Wenn außerdem Spalten auf automatische Größenänderung festgelegt werden, kann die Spaltenbreite nicht mit der Maus geändert werden.

Zum programmgesteuerten Anpassen der Spaltenbreite verwenden Sie die AutoResizeColumn-Methode oder die AutoResizeColumns-Methode des DataGridView-Steuerelements, oder legen Sie die Width-Eigenschaft der Spalte fest.

Weitere Informationen zur inhaltsbasierten automatischen Größenänderung finden Sie unter Größenänderungsoptionen im DataGridView-Steuerelement in Windows Forms.

Im folgenden Codebeispiel wird erzwungen, dass eine Spalte ihre Breite automatisch ändert und so an den Inhalt angepasst wird. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die DataGridViewColumn-Klasse.

// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.

.NET Framework