0 out of 1 rated this helpful - Rate this topic

DataGrid.AlternatingRowBackground Property

Silverlight

Gets or sets the Brush that is used to paint the background of odd-numbered rows.

Namespace: System.Windows.Controls
Assembly: System.Windows.Controls.Data (in System.Windows.Controls.Data.dll)

public Brush AlternatingRowBackground { get; set; }

XAML Property Element Usage

<sdk:DataGrid>
  <sdk:DataGrid.AlternatingRowBackground>
    singleBrush
  </sdk:DataGrid.AlternatingRowBackground>
</sdk:DataGrid>

XAML Attribute Usage

<sdk:DataGrid AlternatingRowBackground="colorString"/>

XAML Values

singleBrush: Within opening and closing property elements for sdk:DataGrid.AlternatingRowBackground, exactly one object element for an object that derives from Brush. The object element is typically one of the following Silverlight classes: LinearGradientBrush, RadialGradientBrush, ImageBrush, SolidColorBrush, or VideoBrush.
colorString: The Color for a SolidColorBrush expressed as an attribute string. This can be a named color, an RGB value, or an ScRGB value. RGB or ScRGB may also specify alpha information. See Color.

Property Value

Type: System.Windows.Media.Brush
The brush that is used to paint the background of odd-numbered rows. The default is a SolidColorBrush with a Color value of white (ARGB value #00FFFFFF).

Remarks

Dependency property identifier field: AlternatingRowBackgroundProperty

The RowBackground property is used to paint the background for all rows in the control. However, if the AlternatingRowBackground property value is not null, its value overrides the default background value for rows with odd-numbered index values (which are zero-based).

Examples

The following code example demonstrates how to set the AlternatingRowBackground property. This example is part of a larger example available in the DataGrid class overview.

XAML


<sdk:DataGrid x:Name="dataGrid5" 
    Height="125" Margin="0,5,0,10"
    AutoGenerateColumns="False"
    RowBackground="Azure"
    AlternatingRowBackground="LightSteelBlue">

The following code example demonstrates how to set the AlternatingRowBackground property in code. This example is part of a larger example available in the Walkthrough: Customizing the DataGrid Control Using Properties topic.


private void cbAltRowBrush_SelectionChanged(object sender, SelectionChangedEventArgs e)
{
    ComboBoxItem cbi = ((ComboBox)sender).SelectedItem as ComboBoxItem;

    if (this.dataGrid1 != null)
    {
        if (cbi.Content.ToString() == "Custom")
            this.dataGrid1.AlternatingRowBackground = new SolidColorBrush(Color.FromArgb(255, 130, 175, 200));
        else if (cbi.Content.ToString() == "Default")
            this.dataGrid1.AlternatingRowBackground = new SolidColorBrush(Color.FromArgb(37, 233, 238, 244));
        else if (cbi.Content.ToString() == "Null")
            this.dataGrid1.AlternatingRowBackground = null;
    }
}

Version Information

Silverlight

Supported in: 5, 4, 3

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Reference

DataGrid Class

System.Windows.Controls Namespace

RowBackground

Other Resources

DataGrid

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD