Export (0) Print
Expand All
Expand Minimize

DataGridView.RowHeadersDefaultCellStyle Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets the default style applied to the row header cells.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in 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)

Property Value

The DataGridViewCellStyle that represents the default style applied to the row header cells.

The default DataGridViewCellStyle returned by this property has the following initial property values.

DataGridViewCellStyle property

Default value

BackColor

The value of the SystemBrushes.Control property.

ForeColor

The value of the SystemBrushes.WindowText property.

SelectionBackColor

The value of the SystemBrushes.Highlight property.

SelectionForeColor

The value of the SystemBrushes.HighlightText property.

Font

The value of the Font property.

Alignment

DataGridViewContentAlignment.MiddleLeft

WrapMode

DataGridViewTriState.True

These values automatically override the values set through the DefaultCellStyle property. To force row headers to inherit the DefaultCellStyle values, you must set the values in the RowHeadersDefaultCellStyle object to the default values indicated for the DataGridViewCellStyle class.

For more information about cell style inheritance, see Cell Styles in the Windows Forms DataGridView Control.

The following code example illustrates how to use this property in a DataGridView with custom colors. Note how the DataGridViewCellStyle.SelectionBackColor property is set to Color.Empty so that the value is inherited from the DefaultCellStyle object.

This example is part of a larger example provided in the DataGridViewCellStyle class overview.

// 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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft