Version

ResolveLocationAppearance(UltraNavigationBarLocation,LocationElementKind,AppearanceData,AppearancePropFlags,LocationUIState) Method

Resolves the appearance for the specified UltraNavigationBarLocation instance.
Syntax
'Declaration
 
Public Overloads Sub ResolveLocationAppearance( _
   ByVal location As UltraNavigationBarLocation, _
   ByVal element As LocationElementKind, _
   ByRef appearance As Infragistics.Win.AppearanceData, _
   ByRef requestedProps As Infragistics.Win.AppearancePropFlags, _
   ByVal state As LocationUIState _
) 
public void ResolveLocationAppearance( 
   UltraNavigationBarLocation location,
   LocationElementKind element,
   ref Infragistics.Win.AppearanceData appearance,
   ref Infragistics.Win.AppearancePropFlags requestedProps,
   LocationUIState state
)

Parameters

location
A reference to the UltraNavigationBarLocation instance for which the appearance is to be resolved.
element
The LocationElementKind constant which identifies the user interface element for which the appearance is to be resolved, i.e, the LocationTextButtonUIElement, the LocationDropDownButtonUIElement, or LocationListItemUIElement.
appearance
A reference to the AppearanceData struct to be resolved.
requestedProps
A reference to the AppearancePropFlags bitflags enumeration which defines the properties to be resolved.
state
The user interface state of the location.
Example
The following code sample demonstrates how to use the UltraNavigationBarLocation's 'State' property to exclude one or more user interface states when resolving its appearance:

Imports System
Imports System.Drawing
Imports System.IO
Imports System.Collections.Generic
Imports System.ComponentModel
Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.Misc
Imports Infragistics.Win.Misc.UltraWinNavigationBar


    ' Resolves the appearance for the specified UltraNavigationBarLocation,
    ' without factoring in the appearances that are related to the states
    ' specified by the 'ignoredStates' parameter.
    Private Sub ResolveLocationAppearance(ByVal location As UltraNavigationBarLocation, _
                                            ByVal elementKind As LocationElementKind, _
                                            ByRef appearance As AppearanceData, _
                                            ByRef requestedProps As AppearancePropFlags, _
                                            ByVal ignoredStates As LocationUIState)

        '  Throw an exception if the caller specified a null location,
        '  or one that is not associated with any control.
        If location Is Nothing Then Throw New ArgumentNullException("location")

        If location.NavigationBar Is Nothing Then Throw New Exception("The specified UltraNavigationBarLocation is not associated with an UltraNavigationBar control.")

        '  Get the actual state of the location from its 'State' property.
        Dim actualState As LocationUIState = location.State

        '  Strip the bits from the specified 'ignoredStates' value.
        Dim state As LocationUIState = actualState
        state = state And (Not ignoredStates)

        '  Resolve the appearance, using the modified state information.
        location.NavigationBar.ResolveLocationAppearance(location, elementKind, appearance, requestedProps, state)

    End Sub
using System;
using System.Drawing;
using System.IO;
using System.Collections.Generic;
using System.ComponentModel;
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.Misc;
using Infragistics.Win.Misc.UltraWinNavigationBar;

    // Resolves the appearance for the specified UltraNavigationBarLocation,
    // without factoring in the appearances that are related to the states
    // specified by the 'ignoredStates' parameter.
    private void ResolveLocationAppearance( UltraNavigationBarLocation location,
                                            LocationElementKind elementKind,
                                            ref AppearanceData appearance,
                                            ref AppearancePropFlags requestedProps,
                                            LocationUIState ignoredStates )
    {
        //  Throw an exception if the caller specified a null location,
        //  or one that is not associated with any control.
        if ( location == null )
            throw new ArgumentNullException("location");

        if ( location.NavigationBar == null )
            throw new Exception("The specified UltraNavigationBarLocation is not associated with an UltraNavigationBar control.");

        //  Get the actual state of the location from its 'State' property.
        LocationUIState actualState = location.State;

        //  Strip the bits from the specified 'ignoredStates' value.
        LocationUIState state = actualState;
        state &= ~ignoredStates;

        //  Resolve the appearance, using the modified state information.
        location.NavigationBar.ResolveLocationAppearance( location, elementKind, ref appearance, ref requestedProps, state );
    }
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