Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

RowAppearance Property (UltraGridOverride)

Returns or sets the Appearance object for non-alternate rows.
Syntax
'Declaration
 
Public Property RowAppearance As Infragistics.Win.AppearanceBase
public Infragistics.Win.AppearanceBase RowAppearance {get; set;}
Remarks

The RowAppearance property is used to specify the appearance of all the rows in a band or the grid. You can use this property in combination with RowAlternateAppearance to apply different formatting options to odd and even rows in the grid. Odd-numbered rows will use the Appearance specified by the RowAppearance property. If you do not specify a value for RowAlternateAppearance, the Appearance specified by RowAppearance will apply to all the rows in the band or the grid.

When you assign an Appearance object to the RowAppearance property, the properties of that object will be applied to all the applicable rows belonging to the object specified. You can use the RowAppearance property to examine or change any of the appearance-related properties that are currently assigned to the rows, for example:

UltraWinGrid1.Override.RowAppearance.ForeColor = vbYellow

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

You can override the RowAppearance setting for specific rows by setting the Appearance property of the UltraGridRow object directly. The row will always use the values of its own Appearance object before it will use the values inherited from the Appearance object specified by the RowAppearance property of the band it occupies.

Example
Following code sets the row appearance on override as well as a row.

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

  Private Sub Button82_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button82.Click

      ' RowAppearance applies to rows in the grid. It also applies to cells since they are
      ' part of rows.

      ' Set the RowAppearance on the layout's override.
      Me.ultraGrid1.DisplayLayout.Override.RowAppearance.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.RowAppearance.BackColor = Color.LightBlue

      ' You can also set the row appearance for an individual row.
      Me.ultraGrid1.Rows(0).Appearance.BackColor = Color.Red

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

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

	// RowAppearance applies to rows in the grid. It also applies to cells since they are
	// part of rows.

	// Set the RowAppearance on the layout's override.
	this.ultraGrid1.DisplayLayout.Override.RowAppearance.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.RowAppearance.BackColor = Color.LightBlue;

	// You can also set the row appearance for an individual row.
	this.ultraGrid1.Rows[0].Appearance.BackColor = Color.Red;

}
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