Version

State Property (UltraNavigationBarLocation)

Returns the state of this UltraNavigationBarLocation instance in the user interface.
Syntax
'Declaration
 
Public ReadOnly Property State As LocationUIState
public LocationUIState State {get;}
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