Edit

Share via


Frame.NavigationUIVisibility Property

Definition

Gets or sets when the Frame can show its navigation UI.

public:
 property System::Windows::Navigation::NavigationUIVisibility NavigationUIVisibility { System::Windows::Navigation::NavigationUIVisibility get(); void set(System::Windows::Navigation::NavigationUIVisibility value); };
public System.Windows.Navigation.NavigationUIVisibility NavigationUIVisibility { get; set; }
member this.NavigationUIVisibility : System.Windows.Navigation.NavigationUIVisibility with get, set
Public Property NavigationUIVisibility As NavigationUIVisibility

Property Value

A NavigationUIVisibility value that specifies when the Frame can show its navigation UI. The default value is Automatic.

Examples

The following example demonstrates how to make sure the navigation chrome of a Frame is always visible by setting NavigationUIVisibility to Visible.

this.hostFrame.NavigationUIVisibility = NavigationUIVisibility.Visible;
Me.hostFrame.NavigationUIVisibility = NavigationUIVisibility.Visible
<Frame Name="hostFrame" NavigationUIVisibility="Visible"/>

Remarks

By default, a Frame shows its navigation UI automatically when the first entry is added to navigation history. The navigation UI subsequently remains visible, with the back or forward navigation buttons becoming appropriately enabled or disabled to reflect the number of entries in back and forward navigation history.

You can ensure that navigation UI is always visible by setting:

  1. NavigationUIVisibility to Visible

  2. JournalOwnership to OwnsJournal

You set NavigationUIVisibility to Hidden if you want to hide the navigation UI. This might be the case when navigation UI doesn't make sense with the content you are displaying from a Frame, or because you are providing your own navigation UI.

Dependency Property Information

Identifier field NavigationUIVisibilityProperty
Metadata properties set to true None

Applies to