Esta documentación está archivada y no tiene mantenimiento.

DataGridView.RowHeadersDefaultCellStyle (Propiedad)

Obtiene o establece el estilo predeterminado aplicado a las celdas de encabezado de fila.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public DataGridViewCellStyle RowHeadersDefaultCellStyle { get; set; }
/** @property */
public DataGridViewCellStyle get_RowHeadersDefaultCellStyle ()

/** @property */
public void set_RowHeadersDefaultCellStyle (DataGridViewCellStyle value)

public function get RowHeadersDefaultCellStyle () : DataGridViewCellStyle

public function set RowHeadersDefaultCellStyle (value : DataGridViewCellStyle)

No aplicable.

Valor de propiedad

La propiedad DataGridViewCellStyle que representa el estilo predeterminado aplicado a las celdas de encabezado de fila.

El valor predeterminado de DataGridViewCellStyle devuelto por esta propiedad tiene los siguientes valores de propiedad iniciales.

Propiedad DataGridViewCellStyle

Valor predeterminado

BackColor

Valor de la propiedad SystemBrushes.Control.

ForeColor

Valor de la propiedad SystemBrushes.WindowText.

SelectionBackColor

Valor de la propiedad SystemBrushes.Highlight.

SelectionForeColor

Valor de la propiedad SystemBrushes.HighlightText.

Font

Valor de la propiedad Font.

Alignment

DataGridViewContentAlignment.MiddleLeft

WrapMode

DataGridViewTriState.True

Estos valores reemplazan automáticamente los valores establecidos a través de la propiedad DefaultCellStyle. Para obligar a los encabezados de fila a heredar los valores de DefaultCellStyle debe establecer los valores del objeto RowHeadersDefaultCellStyle en los valores predeterminados indicados para la clase DataGridViewCellStyle.

Para obtener más información sobre la herencia del estilo de celda, vea Estilos de celda en el control DataGridView de formularios Windows Forms.

En el ejemplo de código siguiente se ilustra cómo utilizar esta propiedad en un DataGridView con colores personalizados. Tenga en cuenta cómo se establece el valor de la propiedad DataGridViewCellStyle.SelectionBackColor en Color.Empty para que se herede el valor del objeto DefaultCellStyle.

Este ejemplo forma parte de un ejemplo más extenso que está disponible en la información general sobre la clase DataGridViewCellStyle.

// 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 Service Pack 4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: