RowSelectorAppearance プロパティ (UltraGridOverride)

行セレクターのデフォルトのAppearanceオブジェクトを設定します。

シンタックス

Visual Basic

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

C#

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

解説

RowSelectorAppearance プロパティは、行セレクターの外観の指定に使用されます。RowSelectorAppearance プロパティに Appearance オブジェクトを割り当てると、その Appearance オブジェクトのプロパティが、UltraGridOverride オブジェクトがどこで使用されているかに応じて、バンドまたはグリッド内のすべての行の行セレクターに適用されます。RowSelectorAppearance プロパティを使用すると、アクティブ セルに現在割り当てられている外観関連のプロパティを調べたり変更したりできます。次に例を示します。

UltraWinGrid1.Override.RowSelectorAppearance.ForeColor = vbBlack

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

使用例

Visual Basic

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#

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;

}