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

Returns or sets the default Appearance object for the row selectors.

Syntax

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

Example

Following code sets the RowSelectors on the layout's override and a band's override.

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

  Private Sub Button81_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button81.Click

      ' RowSelectors indicate whether row selectors are displayed. Each row has a row selector 
      ' on the left side of the row. It's used to activate and select rows. Row selectors are
      ' visible by default, however you can set the RowSelectors property on the override to 
      ' False to hide the row selectors.
      Me.ultraGrid1.DisplayLayout.Bands(0).Override.RowSelectors = DefaultableBoolean.True

      ' You can use the RowSelectorAppearance property customize the appearance of the row 
      ' selectors.
      Me.ultraGrid1.DisplayLayout.Override.RowSelectorAppearance.BackColor = Color.DarkBlue

      ' 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.RowSelectors = DefaultableBoolean.False

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

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

	// RowSelectors indicate whether row selectors are displayed. Each row has a row selector 
	// on the left side of the row. It's used to activate and select rows. Row selectors are
	// visible by default, however you can set the RowSelectors property on the override to 
	// False to hide the row selectors.
	this.ultraGrid1.DisplayLayout.Bands[0].Override.RowSelectors = DefaultableBoolean.True;

	// You can use the RowSelectorAppearance property customize the appearance of the row 
	// selectors.
	this.ultraGrid1.DisplayLayout.Override.RowSelectorAppearance.BackColor = Color.DarkBlue;

	// 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.RowSelectors =  DefaultableBoolean.False;

}

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.

See Also