ResolveAppearance(AppearanceData,AppearancePropFlags) Method

Resolves the ScrollBar's appearance.

Syntax

Visual Basic

'Declaration
 
Public Overloads Sub ResolveAppearance( _
   ByRef appearance As AppearanceData, _
   ByRef requestedProps As AppearancePropFlags _
) 

C#

public void ResolveAppearance( 
   ref AppearanceData appearance,
   ref AppearancePropFlags requestedProps
)

Parameters

appearance

Structure to receive the updated appearance info.

requestedProps

Flag enumeration indicating which properties need to be resolved.

Example

The following sample code illustrates how the resolve the appearance of various parts of the scrollbar by calling methods on the ScrollBarLook object.

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinScrollBar

Private Sub button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button2.Click

    Dim appData As AppearanceData
    Dim requestedProps As AppearancePropFlags

    Dim sbLook As ScrollBarLook

    sbLook = Me.ultraScrollBar1.ScrollBarInfo.ScrollBarLook

    ' -----------------------------------------------
    ' Resolve the default appearance of the scrollbar
    ' -----------------------------------------------

    ' 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 ScrollBarLook's 'ResolveAppearance' method .
    sbLook.ResolveAppearance(appData, requestedProps)

    ' Note: The reason that the 'requestedProps' parameter
    ' is also passed in by reference is that as each requested
    ' property is resolved its bit is stripped out of the
    ' passed in parameter. On return from the call the only
    ' bits remaining in 'requestedProps' will be those 
    ' properties which were not resolved. Normally,
    ' 'requestedProps' has no bits set after the call returns.

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

    ' --------------------------------------------
    ' Resolve the appearance of scroll bar buttons
    ' --------------------------------------------

    ' 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 ScrollBarLook's 'ResolveButtonAppearance' method.
    sbLook.ResolveButtonAppearance(appData, requestedProps)

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


    ' There are also methods for resolving the appearance
    ' of the thumb and the track area.
    'sbLook.ResolveScrollThumbAppearance( ref appData, ref requestedProps )
    'sbLook.ResolveScrollTrackAppearance( ref appData, ref requestedProps )

End Sub

C#

using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinScrollBar;

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

	AppearanceData appData;
	AppearancePropFlags requestedProps;

	ScrollBarLook sbLook = this.ultraScrollBar1.ScrollBarInfo.ScrollBarLook;

	// -----------------------------------------------
	// Resolve the default appearance of the scrollbar
	// -----------------------------------------------

	// 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 ScrollBarLook's 'ResolveAppearance' method .
	sbLook.ResolveAppearance( ref appData, ref requestedProps );
	
	// Note: The reason that the 'requestedProps' parameter
	// is also passed in by reference is that as each requested
	// property is resolved its bit is stripped out of the
	// passed in parameter. On return from the call the only
	// bits remaining in 'requestedProps' will be those 
	// properties which were not resolved. Normally,
	// 'requestedProps' has no bits set after the call returns.

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

	// --------------------------------------------
	// Resolve the appearance of scroll bar buttons
	// --------------------------------------------

	// 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 ScrollBarLook's 'ResolveButtonAppearance' method.
	sbLook.ResolveButtonAppearance( 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() );

		
	// There are also methods for resolving the appearance
	// of the thumb and the track area.
	//sbLook.ResolveScrollThumbAppearance( ref appData, ref requestedProps );
	//sbLook.ResolveScrollTrackAppearance( ref appData, ref 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