(0) exportieren Drucken
Alle erweitern
Erweitern Minimieren

DataGridView.AllowUserToResizeRows-Eigenschaft

Hinweis: Diese Eigenschaft ist neu in .NET Framework, Version 2.0.

Ruft einen Wert ab, der angibt, ob die Größe der Zeilen geändert werden kann, oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public bool AllowUserToResizeRows { get; set; }
/** @property */
public boolean get_AllowUserToResizeRows ()

/** @property */
public void set_AllowUserToResizeRows (boolean value)

public function get AllowUserToResizeRows () : boolean

public function set AllowUserToResizeRows (value : boolean)

Eigenschaftenwert

true, wenn die Größe der Zeilen geändert werden kann, andernfalls false. Der Standardwert ist true.

Mit dieser Eigenschaft verhindern Sie, dass die Zeilenhöhe manuell geändert werden kann. Dies empfiehlt sich beispielsweise bei Steuerelementen, die nur angezeigt werden und in denen Daten einmal geladen werden und sich die Größe der Zeilen zu diesem Zeitpunkt ändert.

Wenn Zellinhalt bei Größenänderungen einer Zeile in mehrere Zeilen umbrochen werden soll, muss der betreffende Zellstil über einen WrapMode-Eigenschaftenwert von True verfügen.

Weitere Informationen zu Größenänderungen durch Benutzer finden Sie unter Größenänderungsoptionen im DataGridView-Steuerelement in Windows Forms.

HinweisHinweis

Das DataGridView-Steuerelement unterstützt keine doppelte Pufferung. Wenn DoubleBuffered in einem abgeleiteten DataGridView-Steuerelement auf true festgelegt ist, erhalten Benutzer beim Ändern der Größe von Zeilen, Spalten oder Kopfzeilen und beim Neuanordnen von Spalten keine visuelle Rückmeldung.

Im folgenden Codebeispiel wird die Verwendung dieser Eigenschaft in einem primär für die Anzeige bestimmten DataGridView-Steuerelement veranschaulicht. In diesem Beispiel wird das Erscheinungsbild des Steuerelements auf verschiedene Weisen angepasst und das Steuerelement für eingeschränkte Interaktivität konfiguriert. Dieses Beispiel ist Teil eines umfangreicheren für die DataGridViewCellStyle-Klassenübersicht bereitgestellten Beispiels.

// Configures the appearance and behavior of a DataGridView control.
private void InitializeDataGridView()
{
    // Initialize basic DataGridView properties.
    dataGridView1.Dock = DockStyle.Fill;
    dataGridView1.BackgroundColor = Color.LightGray;
    dataGridView1.BorderStyle = BorderStyle.Fixed3D;

    // Set property values appropriate for read-only display and 
    // limited interactivity. 
    dataGridView1.AllowUserToAddRows = false;
    dataGridView1.AllowUserToDeleteRows = false;
    dataGridView1.AllowUserToOrderColumns = true;
    dataGridView1.ReadOnly = true;
    dataGridView1.SelectionMode = DataGridViewSelectionMode.FullRowSelect;
    dataGridView1.MultiSelect = false;
    dataGridView1.AutoSizeRowsMode = DataGridViewAutoSizeRowsMode.None;
    dataGridView1.AllowUserToResizeColumns = false;
    dataGridView1.ColumnHeadersHeightSizeMode = 
        DataGridViewColumnHeadersHeightSizeMode.DisableResizing;
    dataGridView1.AllowUserToResizeRows = false;
    dataGridView1.RowHeadersWidthSizeMode = 
        DataGridViewRowHeadersWidthSizeMode.DisableResizing;

    // Set the selection background color for all the cells.
    dataGridView1.DefaultCellStyle.SelectionBackColor = Color.White;
    dataGridView1.DefaultCellStyle.SelectionForeColor = Color.Black;

    // Set RowHeadersDefaultCellStyle.SelectionBackColor so that its default
    // value won't override DataGridView.DefaultCellStyle.SelectionBackColor.
    dataGridView1.RowHeadersDefaultCellStyle.SelectionBackColor = Color.Empty;

    // Set the background color for all rows and for alternating rows. 
    // The value for alternating rows overrides the value for all rows. 
    dataGridView1.RowsDefaultCellStyle.BackColor = Color.LightGray;
    dataGridView1.AlternatingRowsDefaultCellStyle.BackColor = Color.DarkGray;

    // Set the row and column header styles.
    dataGridView1.ColumnHeadersDefaultCellStyle.ForeColor = Color.White;
    dataGridView1.ColumnHeadersDefaultCellStyle.BackColor = Color.Black;
    dataGridView1.RowHeadersDefaultCellStyle.BackColor = Color.Black;

    // Set the Format property on the "Last Prepared" column to cause
    // the DateTime to be formatted as "Month, Year".
    dataGridView1.Columns["Last Prepared"].DefaultCellStyle.Format = "y";

    // Specify a larger font for the "Ratings" column. 
    using (Font font = new Font(
        dataGridView1.DefaultCellStyle.Font.FontFamily, 25, FontStyle.Bold))
    {
        dataGridView1.Columns["Rating"].DefaultCellStyle.Font = font;
    }

    // Attach a handler to the CellFormatting event.
    dataGridView1.CellFormatting += new
        DataGridViewCellFormattingEventHandler(dataGridView1_CellFormatting);
}

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0
Anzeigen:
© 2014 Microsoft