Infragistics(R) NetAdvantage(R) Windows Forms
RowSelectorAppearance Property
See Also  Example E-mail your feedback on this topic.
Infragistics.Win.UltraWinGrid Namespace > UltraGridRow Class : RowSelectorAppearance Property

Determines how the row selectors will look.

Syntax

Visual Basic (Declaration) 
Public Property RowSelectorAppearance As Infragistics.Win.Appearance
C# 
public Infragistics.Win.Appearance RowSelectorAppearance {get; set;}

Example

Following code sets RowSelectorAppearance property on various objects in the UltraGrid.

Visual BasicCopy Code
Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub Button111_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button111.Click

      ' You can set RowSelectorAppearance on three objects. These objects are at different
      ' level in the UltraGrid's resolution hierarchy.

      ' Get the layout, a band, a column, a row and a cell for the demonstration purpose.
      Dim layout As UltraGridLayout = Me.UltraGrid1.DisplayLayout
      Dim band As UltraGridBand = layout.Bands(0)
      Dim row As UltraGridRow = Me.UltraGrid1.Rows(0)

      ' Set grid-wide row selector appearance by using the layout's Override.
      layout.Override.RowSelectorAppearance.BackColor = Color.Yellow

      ' You can override above settings for a a band by setting the 
      ' Override.RowSelectorAppearance on the band. This will have higher precedence than
      ' the layout.Override.
      band.Override.RowSelectorAppearance.BackColor = Color.Magenta

      ' In the same manner, you can override row selector appearance for a particular
      ' row.
      row.RowSelectorAppearance.BackColor = Color.Green

  End Sub
C#Copy Code
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void button111_Click(object sender, System.EventArgs e)
{

	// You can set RowSelectorAppearance on three objects. These objects are at different
	// level in the UltraGrid's resolution hierarchy.

	// Get the layout, a band, a column, a row and a cell for the demonstration purpose.
	UltraGridLayout layout = this.ultraGrid1.DisplayLayout;
	UltraGridBand   band   = layout.Bands[0];
	UltraGridRow    row    = this.ultraGrid1.Rows[0];

	// Set grid-wide row selector appearance by using the layout's Override.
	layout.Override.RowSelectorAppearance.BackColor = Color.Yellow;

	// You can override above settings for a a band by setting the 
	// Override.RowSelectorAppearance on the band. This will have higher precedence than
	// the layout.Override.
	band.Override.RowSelectorAppearance.BackColor = Color.Magenta;

	// In the same manner, you can override row selector appearance for a particular
	// row.
	row.RowSelectorAppearance.BackColor = Color.Green;			

}

Remarks

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

UltraWinGrid1.Override.RowSelectorAppearance.ForeColor = vbBlack

Because you may want the row selectors to look different at different levels of a hierarchical record set, RowSelectorAppearance is a property of the UltraGridOverride object. This makes it easy to specify different row selector 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 selectors will use the grid-level setting of RowSelectorAppearance.

To display row selectors set the property.

See Also