NavigationEventArgs class (Windows)

This topic has not yet been rated - Rate this topic

Provides data for navigation methods and event handlers that cannot cancel the navigation request.

Inheritance

Object
NavigationEventArgs

Syntax


public sealed class NavigationEventArgs : Object

Attributes

MarshalingBehaviorAttribute(Agile)
ThreadingAttribute(Both)
VersionAttribute(NTDDI_WIN8)
WebHostHiddenAttribute()

Members

The NavigationEventArgs class has these types of members:

Methods
Properties

Methods

The NavigationEventArgs class inherits methods from the Object class.

Properties

The NavigationEventArgs class has these properties.

Property	Access type	Description
Content	Read-only	Gets the root node of the target page's content.
NavigationMode	Read-only	Gets a value that indicates the direction of movement during navigation
Parameter	Read-only	Gets any Parameter object passed to the target page for the navigation.
SourcePageType	Read-only	Gets the data type of the target page.
Uri	Read/write	Gets the Uniform Resource Identifier (URI) of the target.

Examples

The following example code demonstrates the use of this type. For the complete code listing, see the XAML WebView control sample.

C++


private void NavigateButton_Click(object sender, RoutedEventArgs e)
{
    ProgressRing1.IsActive = true;

    // Provide an indication as to where we are trying to navigate to
    rootPage.NotifyUser(String.Format("Navigating to: {0}", Address.Text), NotifyType.StatusMessage);

    // Hook the LoadCompleted event for the WebView to know when the URL is fully loaded
    WebView1.LoadCompleted += new Windows.UI.Xaml.Navigation.LoadCompletedEventHandler(WebView1_LoadCompleted);

    // Attempt to navigate to the specified URL.  Notice that a malformed URL will raise a FormatException
    // which we catch and let the user know that the URL is bad and to enter a new well-formed one.
    try
    {
        Uri targetUri = new Uri(Address.Text);
        WebView1.Navigate(targetUri);
    }
    catch (FormatException myE)
    {
        // Bad address
        rootPage.NotifyUser(String.Format("Address is invalid, try again.  Details --> {0}", myE.Message), NotifyType.ErrorMessage);
    }
}

void WebView1_LoadCompleted(object sender, Windows.UI.Xaml.Navigation.NavigationEventArgs e)
{
    WebView1.Visibility = Windows.UI.Xaml.Visibility.Visible;
    BlockingRect.Visibility = Windows.UI.Xaml.Visibility.Collapsed;
    ProgressRing1.IsActive = false;

    // Tell the user that the page has loaded
    rootPage.NotifyUser("Page loaded", NotifyType.StatusMessage);
}

void Address_KeyUp(object sender, KeyRoutedEventArgs e)
{
    if (e.Key == Windows.System.VirtualKey.Enter)
    {
        NavigateButton_Click(this, new RoutedEventArgs());
    }
}

Requirements

Minimum supported client	Windows 8 [Windows Store apps only]
Minimum supported server	Windows Server 2012 [Windows Store apps only]
Namespace	Windows.UI.Xaml.Navigation Windows::UI::Xaml::Navigation [C++]
Metadata	Windows.winmd

NavigationEventArgs class