Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

ResolveFillAppearance(IProgressBarInfo,AppearanceData,AppearancePropFlags) Method

Static method for resolving the appearance for the filled area of the element.
Syntax
'Declaration
 
Public Overloads Shared Sub ResolveFillAppearance( _
   ByVal progressInfo As IProgressBarInfo, _
   ByRef appearance As AppearanceData, _
   ByRef requestedProps As AppearancePropFlags _
) 
public static void ResolveFillAppearance( 
   IProgressBarInfo progressInfo,
   ref AppearanceData appearance,
   ref AppearancePropFlags requestedProps
)

Parameters

progressInfo
Object implementing the IProgressBarInfo.
appearance
AppearanceData to update with the Appearance information.
requestedProps
Appearance properties to resolve.
Remarks

The main source for the resolved values of the filled appearance is the IProgressBarInfo.FillAppearance. However, since the text from the filled and unfilled area must be sized and positioned exactly the same, the Infragistics.Win.AppearanceBase.FontData, Infragistics.Win.AppearanceBase.TextTrimming, Infragistics.Win.AppearanceBase.TextHAlign, and Infragistics.Win.AppearanceBase.TextVAlign are resolved using the corresponding values of the IProgressBarInfo.Appearance.

Example
The following sample code illustrates how the resolve the appearance of an UltraProgressBar control.

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinProgressBar
Imports System.Diagnostics

   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

       ' ----------------------------------------
       ' Resolve the appearance of a progress bar
       ' ----------------------------------------

       ' 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 control's 'ResolveAppearance' method
       Me.ultraProgressBar1.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 for the fill 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 'ResolveFillAppearance' method
       ' to resolve the appearance of the fill area of the 
       ' control.
       Me.ultraProgressBar1.ResolveFillAppearance(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.UltraWinProgressBar;

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

	AppearanceData appData;
	AppearancePropFlags requestedProps;

	// ----------------------------------------
	// Resolve the appearance of a progress bar
	// ----------------------------------------

	// 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 control's 'ResolveAppearance' method
	this.ultraProgressBar1.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 for the fill 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 'ResolveFillAppearance' method
	// to resolve the appearance of the fill area of the 
	// control.
	this.ultraProgressBar1.ResolveFillAppearance( 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