RowAlternateAppearance プロパティ (UltraGridOverride)

互い違いの行のためのAppearanceオブジェクトを設定します。

シンタックス

Visual Basic

'宣言
 
Public Property RowAlternateAppearance As Infragistics.Win.AppearanceBase

C#

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

解説

RowAlternateAppearance プロパティは、グリッドの奇数行と偶数行に異なる書式オプションを適用するために RowAppearance プロパティに組み合わせて使用されます。偶数行は、RowAlternateAppearance プロパティで指定された Appearance を使用します。RowAlternateAppearance に値を指定していない場合、RowAlternateAppearance で指定された Appearance はバンドまたはグリッドのすべての行に適用されます。

RowAlternateAppearance プロパティに Appearance オブジェクトを割り当てると、指定したオブジェクトに属するすべての偶数行にそのオブジェクトのプロパティが適用されます。RowAlternateAppearance プロパティを使用すると、行に現在割り当てられている外観関連のプロパティを調べたり変更したりできます。次に例を示します。

UltraWinGrid1.Override.RowAppearance.ForeColor = vbRed

RowAlternateAppearance は UltraGridOverride オブジェクトのプロパティなので、階層的なレコードセットの各レベルで隔行に異なる外観を与えることができます。バンドごとに隔行の外観を変更するには、各 UltraGridBand オブジェクトに独自の UltraGridOverride オブジェクトを割り当てます。バンドにオーバーライドが割り当てられていない場合は、オーバーライド階層の１つ上のレベルのオーバーライドを使用して、そのバンドのプロパティが決定されます。つまり、オーバーライドを持たないバンドはその親バンドのオーバーライドを使用し、最上位のバンドはグリッドのオーバーライドを使用します。したがって、最上位のバンドに独自のオーバーライドが設定されていない場合、そのバンドの隔行はグリッド レベルの RowAlternateAppearance の設定を使用します。

UltraGridRow オブジェクトの Appearance プロパティを直接設定すれば、特定の行の RowAlternateAppearance 設定をオーバーライドできます。行は常に、その属するバンドの RowAlternateAppearance プロパティで指定された Appearance オブジェクトから引き継がれた値よりも独自の Appearance オブジェクトの値を優先して使用します。

使用例

Visual Basic

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

  Private Sub Button47_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button47.Click

      ' RowAlternateAppearance applies to alternate rows in the UltraGrid.

      ' Set the RowAlternateAppearance on the layout's override.
      Me.ultraGrid1.DisplayLayout.Override.RowAlternateAppearance.BackColor = Color.LightSkyBlue

      ' 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.RowAlternateAppearance.BackColor = Color.LightYellow

  End Sub

C#

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

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

	// RowAlternateAppearance applies to alternate rows in the UltraGrid.

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

	// 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.RowAlternateAppearance.BackColor = Color.LightYellow;

}