ResolveBandLabelAppearance(AppearanceData) メソッド

GroupByBoxのBandラベルの外観プロパティをすべて解決します。

シンタックス

Visual Basic

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

C#

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

パラメータ

appData

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

解説

このメソッドを使用して、GroupByBox の Band ラベルを書式設定するために使用する実際の値を取得します。このメソッドは、必要に応じて Appearance 階層を追跡して、すべての Appearance プロパティの値を返します。

使用例

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

C#

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 );

}