Version

ResolveAppearance Method (UltraTabControlBase)

Resolves the default appearance of tabs
Syntax
'Declaration
 
Public Sub ResolveAppearance( _
   ByRef appearance As Infragistics.Win.AppearanceData, _
   ByRef requestedProps As Infragistics.Win.AppearancePropFlags _
) 
public void ResolveAppearance( 
   ref Infragistics.Win.AppearanceData appearance,
   ref Infragistics.Win.AppearancePropFlags requestedProps
)

Parameters

appearance
requestedProps
Example
The following sample code illustrates how to resolve the appearance of tabs.

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTabs
Imports Infragistics.Win.UltraWinTabControl

Private Sub button10_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button10.Click

    Dim appData As AppearanceData
    Dim requestedProps As AppearancePropFlags
    Dim tab As UltraTab

    ' ------------------------------------------
    ' Resolve the appearance of the selected tab
    ' ------------------------------------------

    ' Get the selected tab
    tab = Me.ultraTabControl1.SelectedTab

    If tab 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 one of the 3 tab 'ResolveAppearance' method overloads.

    ' The first overload resolves the appearance based on the
    ' tab's current state (i.e. selected, hot tracked etc.)
    tab.ResolveAppearance(appData, requestedProps)

    ' The second overload takes a boolean as the 3rd parameter
    ' that resolves the appearance based on the tab's current 
    ' state but exlcudes the hot track apppearance settings
    'tab.ResolveAppearance( appData, requestedProps, true )

    ' The this overload resolves the appearance based on 
    ' an explicit state parameter
    'tab.ResolveAppearance(appData, requestedProps, TabState.Hot Or TabState.Selected)

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

    ' ----------------------------------
    ' Resolve the default tab appearance
    ' ----------------------------------

    ' 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 control's 'ResolveAppearance' method
    ' which will resolve the deafult appearance for tabs.
    Me.ultraTabControl1.ResolveAppearance(appData, requestedProps)

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

    ' -------------------------------------------------
    ' Resolve the default appearance of the client area
    ' -------------------------------------------------

    ' 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 control's 'ResolveClientAreaAppearance' method
    ' which will resolve the deafult appearance for client area
    ' which does not include the tab header area.
    Me.ultraTabControl1.ResolveClientAreaAppearance(appData, requestedProps)

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

End Sub
using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinTabs;
using Infragistics.Win.UltraWinTabControl;

private void button10_Click(object sender, System.EventArgs e)
{
	AppearanceData appData;
	AppearancePropFlags requestedProps;
	UltraTab tab;

	// ------------------------------------------
	// Resolve the appearance of the selected tab
	// ------------------------------------------

	// Get the selected tab
	tab = this.ultraTabControl1.SelectedTab;

	if ( tab == 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 one of the 3 tab 'ResolveAppearance' method overloads.

	// The first overload resolves the appearance based on the
	// tab's current state (i.e. selected, hot tracked etc.)
	tab.ResolveAppearance( ref appData, requestedProps );

	// The second overload takes a boolean as the 3rd parameter
	// that resolves the appearance based on the tab's current 
	// state but exlcudes the hot track apppearance settings
	//tab.ResolveAppearance( ref appData, requestedProps, true );

	// The this overload resolves the appearance based on 
	// an explicit state parameter
	//tab.ResolveAppearance( ref appData, requestedProps, TabState.Hot | TabState.Selected );

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

	// ----------------------------------
	// Resolve the default tab appearance
	// ----------------------------------

	// 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 control's 'ResolveAppearance' method
	// which will resolve the deafult appearance for tabs.
	this.ultraTabControl1.ResolveAppearance( ref appData, ref requestedProps );

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

	// -------------------------------------------------
	// Resolve the default appearance of the client area
	// -------------------------------------------------

	// 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 control's 'ResolveClientAreaAppearance' method
	// which will resolve the deafult appearance for client area
	// which does not include the tab header area.
	this.ultraTabControl1.ResolveClientAreaAppearance( ref appData, ref requestedProps );

	// Write out the resolved gradient related properties.
	Debug.WriteLine("BackGradientStyle: " + appData.BackGradientStyle.ToString() + ", BackColor: " + appData.BackColor.ToString() + ", BackColor2: " + appData.BackColor2.ToString() );
		
}
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