Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

ResolveBandLabelAppearance(AppearanceData) Method

Resolves all of the GroupByBox's Band label appearance properties.
Syntax
'Declaration
 
Public Overloads Sub ResolveBandLabelAppearance( _
   ByRef appData As Infragistics.Win.AppearanceData _
) 
public void ResolveBandLabelAppearance( 
   ref Infragistics.Win.AppearanceData appData
)

Parameters

appData
The structure to contain the resolved apperance.
Remarks

Use this method to retrieve the actual values that are being used to format the Band labels of the GroupByBox. This method returns a value for all Appearance properties, tracing up the Appearance hierarchy if necessary.

Example
The following sample code illustrates how to resolve the appearance of various items in an UltraGrid control.

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

}
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also