Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

ActiveCellAppearance Property

Returns or sets the active cell's Appearance object.
Syntax
'Declaration
 
Public Property ActiveCellAppearance As Infragistics.Win.AppearanceBase
public Infragistics.Win.AppearanceBase ActiveCellAppearance {get; set;}
Remarks

The ActiveCellAppearance property is used to specify the appearance of the active cell (as determined by the ActiveCell property). When you assign an Appearance object to the ActiveCellAppearance property, the properties of that object will be applied to any cell that becomes the active cell. You can use the ActiveCellAppearance property to examine or change any of the appearance-related properties that are currently assigned to the active cell, for example:

UltraWinGrid1.Override.ActiveCellAppearance.BackColor = vbBlue

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

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

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

  Private Sub Button27_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button27.Click

      ' ActiveCellAppearance appearance applies to the cell that's active in the UltraGrid. 
      ' This is the cell that's returned by ActiveCell property off the UltraGrid.

      ' Set the ActiveCellAppearance on the layout's Override so that it applies to the active
      ' cell in any band.
      Me.UltraGrid1.DisplayLayout.Override.ActiveCellAppearance.BackColor = Color.LightYellow

      ' You can override that grid-wide setting for a particular band by setting it on the
      ' override of that band.
      Me.UltraGrid1.DisplayLayout.Bands(0).Override.ActiveCellAppearance.BackColor = Color.Orange

  End Sub
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

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

	// ActiveCellAppearance appearance applies to the cell that's active in the UltraGrid. 
	// This is the cell that's returned by ActiveCell property off the UltraGrid.

	// Set the ActiveCellAppearance on the layout's Override so that it applies to the active
	// cell in any band.
	this.ultraGrid1.DisplayLayout.Override.ActiveCellAppearance.BackColor = Color.LightYellow;

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

}
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

See Also