This documentation is archived and is not being maintained.

DataGrid.SelectionBackColor Property

Gets or sets the background color of selected rows.

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

public Color SelectionBackColor { get; set; }
/** @property */
public Color get_SelectionBackColor ()

/** @property */
public void set_SelectionBackColor (Color value)

public function get SelectionBackColor () : Color

public function set SelectionBackColor (value : Color)

Not applicable.

Property Value

A Color that represents the background color of selected rows. The default is the ActiveCaption color.

You typically use this method if you are either creating a designer for the System.Windows.Forms.DataGrid or creating your own control incorporating the System.Windows.Forms.DataGrid.

The following code example demonstrates the use of this member.

// String variable used to show message.
string myString = "Selection backgound color changed from: ";
// Store current foreground color of selected cells.
Color myCurrentColor = myDataGrid.SelectionBackColor;
myString += myCurrentColor.ToString();
// Reset selection background color to default.
myDataGrid.ResetSelectionBackColor();
myString += "  to ";
myString += myDataGrid.SelectionBackColor.ToString();
// Show information about changes in color setting.  
MessageBox.Show(myString, "Selection background color information");

// String variable used to show message.
String myString = "Selection backgound color changed from: ";

// Store current foreground color of selected cells.
Color myCurrentColor = myDataGrid.get_SelectionBackColor();

myString += myCurrentColor.ToString();

// Reset selection background color to default.
myDataGrid.ResetSelectionBackColor();
myString += "  to ";
myString += myDataGrid.get_SelectionBackColor().ToString();

// Show information about changes in color setting.  
MessageBox.Show(myString, "Selection background color information");

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0
Show: