ResolveAppearance(AppearanceData) メソッド

行オブジェクトの外観を解決し、解決された値を、指定した外観データ構造体に設定します。

シンタックス

Visual Basic
C#

'宣言
 
Public Overloads Sub ResolveAppearance( _
   ByRef appData As Infragistics.Win.AppearanceData _
)

public void ResolveAppearance( 
   ref Infragistics.Win.AppearanceData appData
)

パラメータ

appData: 解決された外観を格納する構造体。

解説

Appearance プロパティの未設定の値を調べると、Appearance オブジェクトによって制御されるオブジェクトの表示に実際に使用される内部値ではなく、"use default" 値が返されます。実際に使用される値を調べるためには、ResolveAppearanceメソッドを使用する必要があります。このメソッドは、指定された AppearanceData 構造体を解決された値で初期化します。この構造体を参照することでオブジェクトの外観を確認できます。

Appearance オブジェクトのプロパティを変更するとき、そのオブジェクトがサポートするすべてのプロパティの値を指定する必要はありません。Appearanceオブジェクトが、ゼロから新規に作成したスタンドアロンオブジェクトであるか、またはすでに他のオブジェクトに関連付けられている組み込みオブジェクトであるかにかかわらず、ある特定のプロパティのみを設定し、それ以外のプロパティを無視することが可能です。明示的に設定していないオブジェクトには、そのプロパティに特定の設定がないことを示す "use default" 値が与えられます。

"use default" 値に設定されたプロパティは、外観の階層に従って他のオブジェクトから設定を継承します。外観階層内の各オブジェクトは、"use default"値の代わりに実際に使用する数値を継承するための親オブジェクトを持っています。"use default"値をプロパティの初期設定と混同しないでください。プロパティの初期設定は通常"デフォルト値"と呼びます。多くの場合、オブジェクトのプロパティのデフォルト設定は"use default"です。これは、そのプロパティが初期状態では特定の値を使用するように設定されていないことを意味します。"use default" 値は、列挙プロパティ (通常は "default" で終わる定数で示されます。AlignDefault など) では 0、数値設定 (色関連プロパティで使用される設定など) では -１ (0xFFFFFFFF) です。

したがって、たとえばセルの Appearance オブジェクトの BackColorプロパティが -1 に設定されている場合、コントロールはそのセルの行の BackColorプロパティの設定を使用します。外観階層の最上位は UltraGrid コントロール自体です。UltraWinGridのAppearanceオブジェクトのいずれかのプロパティが"use default"値に設定されている場合、コントロールはそのプロパティの組み込みの値 ("ファクトリプリセット") を使用します。たとえば、グリッドの Appearance オブジェクトの BackColor プロパティのファクトリプリセットは、システムボタン表面色 (0x8000000F) です。グリッドの Appearance オブジェクトの BackColor プロパティが "use default" 値に設定されている場合は、この値がグリッドの背景色に使用されます。

ResolveAppearance メソッドは、指定された AppearanceData 構造体を、そのすべての "use default" 設定を実際の値に変換した結果で初期化します。そのためこのメソッドは、明示的な設定が見つかるか、またはファクトリプリセットに達するまで、各プロパティの外観階層を移動します。単にグリッドをフォームに配置してプロジェクトを実行し、グリッドの組み込み Appearance オブジェクトの BackColorプロパティの設定を調べるには、次のコードを使用します。

MsgBox Hex(UltraWinGrid1.Rows(0).Appearance.BackColor)

...「use default」値 (0xFFFFFFFF) に設定されていることを確認します。ただし、ResolveAppearance メソッドを使用して同じ値を表示する場合は、次のコードを使用します。

Dim appData as AppearanceData = new AppearanceData()

UltraWinGrid1.Rows(0).ResolveAppearance(ByRef appData)

MsgBox Hex(appData.BackColor)

...システムボタン表面色 (0x8000000F) に設定されていることを確認します。

使用例

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid
Imports System.Diagnostics

   Private Sub button4_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button4.Click

       Dim appData As AppearanceData
       Dim requestedProps As AppearancePropFlags
       Dim cell As UltraGridCell
       Dim row As UltraGridRow

       ' -----------------------------------------
       ' Resolve the appearance of the active cell
       ' -----------------------------------------

       ' Get the active cell
       cell = Me.ultraGrid1.ActiveCell

       If cell Is Nothing Then Return

       ' Initialize the appearance data structure		
       appData = New AppearanceData()

       ' Specify which appearance properties we want to resolve.
       ' In this case just the backcolor and forecolor.
       requestedProps = AppearancePropFlags.BackColor Or AppearancePropFlags.ForeColor

       ' Call the cell's 'ResolveAppearance' method.
       cell.ResolveAppearance(appData, requestedProps)

       ' Write out the resolved colors
       Debug.WriteLine("BackColor: " + appData.BackColor.ToString() + ", ForeColor: " + appData.ForeColor.ToString())

       ' ------------------------------------------------
       ' Resolve the appearance of the cell's row
       ' ------------------------------------------------

       ' get the cell's row
       row = cell.Row

       ' Re-initialize the appearance data structure 
       appData = New AppearanceData()

       ' Specify which appearance properties we want to resolve.
       ' In this case we want all 'Render' properties. This
       ' includes every property but the 'Cursor' property.
       requestedProps = AppearancePropFlags.AllRender

       ' Call the row's 'ResolveAppearance' method.
       ' The third parameter indicates whether resolve the 
       ' apperance of the preview area or not.
       row.ResolveAppearance(appData, requestedProps, False)

       ' Write out the resolved gradient related properties.
       Debug.WriteLine("BackGradientStyle: " + appData.BackGradientStyle.ToString() + ", BackColor: " + appData.BackColor.ToString() + ", BackColor2: " + appData.BackColor2.ToString())

       ' Calling the row's 'ResolveCellAppearance' method is 
       ' functionally equivalent to calling the cell's 
       ' 'ResolveAppearance' method.
       'row.ResolveCellAppearance(cell.Column, appData, requestedProps)

       ' There is also a 'ResolveRowSelectorAppearance' method
       ' exposed off the row.
       'row.ResolveRowSelectorAppearance(appData, requestedProps)

       ' The header object exposed off bands, columns and groups
       ' also exposes a 'ResolveRowSelectorAppearance' method.
       'cell.Column.Header.ResolveAppearance(appData, requestedProps)

       ' The AddNewBox also exposes 'Resolve...' methods.
       'Me.ultraGrid1.DisplayLayout.AddNewBox.ResolveAppearance(appData, requestedProps)
       'Me.ultraGrid1.DisplayLayout.AddNewBox.ResolveButtonAppearance(appData, requestedProps)

       ' The GroupByBox also exposes 'Resolve...' methods.
       'Me.ultraGrid1.DisplayLayout.GroupByBox.ResolveAppearance(appData, requestedProps)
       'Me.ultraGrid1.DisplayLayout.GroupByBox.ResolveBandLabelAppearance(appData, requestedProps)
       'Me.ultraGrid1.DisplayLayout.GroupByBox.ResolvePromptAppearance(appData, requestedProps)

   End Sub

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

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

	AppearanceData appData;
	AppearancePropFlags requestedProps;
	UltraGridCell cell;
	UltraGridRow row;

	// -----------------------------------------
	// Resolve the appearance of the active cell
	// -----------------------------------------

	// Get the active cell
	cell = this.ultraGrid1.ActiveCell;

	if ( cell == null ) return;

	// Initialize the appearance data structure		
	appData = new AppearanceData();

	// Specify which appearance properties we want to resolve.
	// In this case just the backcolor and forecolor.
	requestedProps = AppearancePropFlags.BackColor | AppearancePropFlags.ForeColor;

	// Call the cell's 'ResolveAppearance' method.
	cell.ResolveAppearance( ref appData, requestedProps );

	// Write out the resolved colors
	Debug.WriteLine("BackColor: " + appData.BackColor.ToString() + ", ForeColor: " + appData.ForeColor.ToString() );

	// ------------------------------------------------
	// Resolve the appearance of the cell's row
	// ------------------------------------------------

	// get the cell's row
	row = cell.Row;

	// Re-initialize the appearance data structure 
	appData = new AppearanceData();
	
	// Specify which appearance properties we want to resolve.
	// In this case we want all 'Render' properties. This
	// includes every property but the 'Cursor' property.
	requestedProps = AppearancePropFlags.AllRender;

	// Call the row's 'ResolveAppearance' method.
	// The third parameter indicates whether resolve the 
	// apperance of the preview area or not.
	row.ResolveAppearance( ref appData, requestedProps, false );

	// Write out the resolved gradient related properties.
	Debug.WriteLine("BackGradientStyle: " + appData.BackGradientStyle.ToString() + ", BackColor: " + appData.BackColor.ToString() + ", BackColor2: " + appData.BackColor2.ToString() );

	// Calling the row's 'ResolveCellAppearance' method is 
	// functionally equivalent to calling the cell's 
	// 'ResolveAppearance' method.
	//row.ResolveCellAppearance( cell.Column, ref appData, requestedProps );

	// There is also a 'ResolveRowSelectorAppearance' method
	// exposed off the row.
	//row.ResolveRowSelectorAppearance( ref appData, requestedProps );

	// The header object exposed off bands, columns and groups
	// also exposes a 'ResolveRowSelectorAppearance' method.
	//cell.Column.Header.ResolveAppearance( ref appData, requestedProps );

	// The AddNewBox also exposes 'Resolve...' methods.
	//this.ultraGrid1.DisplayLayout.AddNewBox.ResolveAppearance(ref appData, requestedProps );
	//this.ultraGrid1.DisplayLayout.AddNewBox.ResolveButtonAppearance(ref appData, requestedProps );
	
	// The GroupByBox also exposes 'Resolve...' methods.
	//this.ultraGrid1.DisplayLayout.GroupByBox.ResolveAppearance(ref appData, requestedProps );
	//this.ultraGrid1.DisplayLayout.GroupByBox.ResolveBandLabelAppearance(ref appData, requestedProps );
	//this.ultraGrid1.DisplayLayout.GroupByBox.ResolvePromptAppearance(ref appData, requestedProps );

}

参照

UltraGridRow クラス
 UltraGridRow メンバ
 オーバーロード一覧

Windows Forms | ヘルプ トピック

ResolveAppearance(AppearanceData) メソッド

パラメータ

参照

Windows Forms | ヘルプトピック