Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

AppearanceData Structure

The AppearanceData structure contains the properties that are used to render an object
Syntax
'Declaration
 
Public Structure AppearanceData 
   Inherits System.ValueType
public struct AppearanceData : System.ValueType
Example
The following sample code illustrates how the resolve the appearance of groups and items in an UltraListBar control.

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinListBar

Private Sub button5_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button5.Click

    Dim appData As AppearanceData
    Dim requestedProps As AppearancePropFlags

    ' ---------------------------------
    ' Resolve the appearance of a group 
    ' ---------------------------------

    ' Get the group object.
    Dim grp As Group = Me.ultraListBar1.Groups(0)

    ' 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 group's 'ResolveAppearance' method .
    grp.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 the group's header
    ' --------------------------------------------

    ' 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 group's 'ResolveHeaderAppearance' method.
    grp.ResolveHeaderAppearance(appData, requestedProps)

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


    ' ------------------------
    ' Resolve item appearances
    ' ------------------------

    ' The group's 'ResolveItemAppearance' method will
    ' resolve the default appearance for items in the group.
    'grp.ResolveItemAppearance(appData, requestedProps)

    ' The 'Item' object also exposes a 'ResolveAppearance'
    ' method for resolving the appearance of that item.
    'grp.Items(0).ResolveAppearance(appData, requestedProps)

End Sub
using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinListBar;

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

	AppearanceData appData;
	AppearancePropFlags requestedProps;

	// ---------------------------------
	// Resolve the appearance of a group 
	// ---------------------------------

	// Get the group object.
	Group group = this.ultraListBar1.Groups[0];
	
	// 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 group's 'ResolveAppearance' method .
	group.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 the group's header
	// --------------------------------------------

	// 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 group's 'ResolveHeaderAppearance' method.
	group.ResolveHeaderAppearance( 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 item appearances
	// ------------------------

	// The group's 'ResolveItemAppearance' method will
	// resolve the default appearance for items in the group.
	//group.ResolveItemAppearance( ref appData, ref requestedProps );
		
	// The 'Item' object also exposes a 'ResolveAppearance'
	// method for resolving the appearance of that item.
	//group.Items[0].ResolveAppearance( 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

See Also