HeaderAppearance プロパティ

ヘッダーの書式化属性の設定に使用されるAppearanceオブジェクトを設定します。

シンタックス

Visual Basic

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

C#

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

解説

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

UltraWinGrid1.Override.HeaderAppearance.BackColor = vbBlack

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

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

使用例

Visual Basic

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

  Private Sub Button51_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button51.Click

      ' Set the HeaderAppearance on the layout's override. HeaderAppearance applies to
      ' column headers.
      Me.ultraGrid1.DisplayLayout.Override.HeaderAppearance.BackColor = Color.SkyBlue

      ' 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.HeaderAppearance.BackColor = Color.Red

      ' You can also set the header appearance on individual column headers.
      Me.ultraGrid1.DisplayLayout.Bands(0).Columns(0).Header.Appearance.BackColor = Color.Red

  End Sub

C#

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

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

	// Set the HeaderAppearance on the layout's override. HeaderAppearance applies to
	// column headers.
	this.ultraGrid1.DisplayLayout.Override.HeaderAppearance.BackColor = Color.SkyBlue;

	// 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.HeaderAppearance.BackColor = Color.Red;

	// You can also set the header appearance on individual column headers.
	this.ultraGrid1.DisplayLayout.Bands[0].Columns[0].Header.Appearance.BackColor = Color.Red;

}