RowSelectorHeaderAppearance Property

Returns or sets the default Appearance object for the row selector header.

Syntax

Visual Basic

'Declaration
 
Public Property RowSelectorHeaderAppearance As Infragistics.Win.AppearanceBase

C#

public Infragistics.Win.AppearanceBase RowSelectorHeaderAppearance {get; set;}

Remarks

The RowSelectorHeaderAppearance property is used to specify the appearance of the row selector header. When you assign an Appearance object to the RowSelectorHeaderAppearance property, the properties of that object will be applied to the row selector header for the band or all bands in the grid, depending on where the UltraGridOverride object is being used. You can use the RowSelectorHeaderAppearance property to examine or change any of the appearance-related properties that are currently assigned to the active cell, for example:

UltraWinGrid1.Override.RowSelectorHeaderAppearance.ForeColor = vbBlack

Because you may want the row selector header to look different at different levels of a hierarchical record set, RowSelectorHeaderAppearance is a property of the UltraGridOverride object. This makes it easy to specify different row selector header appearances for each band by assigning each UltraGridBand object its own UltraGridOverride object. If a band does not have an override assigned to it, the control will use the override at the next higher level of the override hierarchy to determine the properties for that band. In other words, any band without an override will use its parent band's override, and the top-level band will use the grid's override. Therefore, if the top-level band does not have its override set, the row selector header will use the grid-level setting of RowSelectorHeaderAppearance.

Example

The following code sets the RowSelectorHeaderAppearance on the layout's override and a band's override.

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid


Private Sub button_Click(sender As Object, e As System.EventArgs)

   ' Display a RowSelectorHeader
   Me.ultraGrid1.DisplayLayout.Override.RowSelectorHeaderStyle = RowSelectorHeaderStyle.SeperateElement
   
   ' Set the RowSelectorHeaderAppearance on the layout's override.
   Me.ultraGrid1.DisplayLayout.Override.RowSelectorHeaderAppearance.BackColor = Color.LightGreen
   
   ' You can override that grid-wide setting for a particular band by setting it on the
   ' override of that band.
   Me.ultraGrid1.DisplayLayout.Bands(1).Override.RowSelectorHeaderAppearance.BackColor = Color.LightYellow

End Sub 'button_Click

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;


private void button_Click(object sender, System.EventArgs e)
{   
    // Display a RowSelectorHeader
    this.ultraGrid1.DisplayLayout.Override.RowSelectorHeaderStyle = RowSelectorHeaderStyle.SeperateElement;

    // Set the RowSelectorHeaderAppearance on the layout's override.
    this.ultraGrid1.DisplayLayout.Override.RowSelectorHeaderAppearance.BackColor = Color.LightGreen;

    // You can override that grid-wide setting for a particular band by setting it on the
    // override of that band.
    this.ultraGrid1.DisplayLayout.Bands[1].Override.RowSelectorHeaderAppearance.BackColor = Color.LightYellow;
}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2