CellAppearance プロパティ (UltraGridOverride)

バンド内またはグリッド内のセルに適用される書式化属性を設定します。

シンタックス

Visual Basic

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

C#

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

解説

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

UltraWinGrid1.Override.CellAppearance.BackColor = vbYellow

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

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

CellAppearance プロパティに指定された Appearance オブジェクトのプロパティのいずれかがデフォルト値に設定されている場合は、セルを含む行の Appearance オブジェクトのプロパティが使用されます。

使用例

Visual Basic

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

  Private Sub Button9_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button9.Click

      ' Get the layout, a band, a column, a row and a cell for the demonstration purpose.
      Dim layout As UltraGridLayout = Me.ultraGrid1.DisplayLayout
      Dim band As UltraGridBand = layout.Bands(0)
      Dim column As UltraGridColumn = band.Columns(0)
      Dim row As UltraGridRow = Me.ultraGrid1.Rows(0)
      Dim cell As UltraGridCell = row.Cells(column)

      ' The way the UltraGrid resolves cell appearance is that objects at a lower level
      ' in the object model hierarchy have higher precedence than objects in higher level.
      ' For example, a cell has a higher precedence than its row. A row has a higher
      ' precedence than a column. The precedence order usually is cell, row, column, band,
      ' layout in decresing precedence order.

      ' Set grid-wide cell appearance by using the layout's Override.
      layout.Override.CellAppearance.BackColor = Color.Yellow

      ' You can override above settings for a a band by setting the 
      ' Override.CellAppearance on the band. This will have higher precedence than
      ' the layout.Override.
      band.Override.CellAppearance.BackColor = Color.Magenta

      ' You can override cell appearance on a column as well so cell-appearance settings
      ' on both the band and the layout will be ignored.
      column.CellAppearance.BackColor = Color.Red

      ' In the same manner, you can override cell-apperance for a row.
      row.CellAppearance.BackColor = Color.Green

      ' You can override the cell-appearance for individual cells.
      cell.Appearance.BackColor = Color.Blue

  End Sub

C#

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

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

	// Get the layout, a band, a column, a row and a cell for the demonstration purpose.
	UltraGridLayout layout = this.ultraGrid1.DisplayLayout;
	UltraGridBand   band   = layout.Bands[0];
	UltraGridColumn column = band.Columns[0];
	UltraGridRow    row    = this.ultraGrid1.Rows[0];
	UltraGridCell    cell   = row.Cells[column];

	// The way the UltraGrid resolves cell appearance is that objects at a lower level
	// in the object model hierarchy have higher precedence than objects in higher level.
	// For example, a cell has a higher precedence than its row. A row has a higher
	// precedence than a column. The precedence order usually is cell, row, column, band,
	// layout in decresing precedence order.

	// Set grid-wide cell appearance by using the layout's Override.
	layout.Override.CellAppearance.BackColor = Color.Yellow;

	// You can override above settings for a a band by setting the 
	// Override.CellAppearance on the band. This will have higher precedence than
	// the layout.Override.
	band.Override.CellAppearance.BackColor = Color.Magenta;

	// You can override cell appearance on a column as well so cell-appearance settings
	// on both the band and the layout will be ignored.
	column.CellAppearance.BackColor = Color.Red;

	// In the same manner, you can override cell-apperance for a row.
	row.CellAppearance.BackColor = Color.Green;

	// You can override the cell-appearance for individual cells.
	cell.Appearance.BackColor = Color.Blue;

}