PageFunction<T> Class

Represents a special type of page that allows you to treat navigation to a page in a similar fashion to calling a method.

Namespace:  System.Windows.Navigation
Assembly:  PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public class PageFunction<T> : PageFunctionBase
<PageFunction x:TypeArguments="T">
  Content
</PageFunction>

Type Parameters

T

The type of value that the PageFunction<T> returns to a caller.

PageFunction<T> essentially allows you to treat a page navigation like a function call, in which a page navigates to (calls) a page function.

To enable function call semantics, PageFunction<T> provides the following capabilities:

  • When the page function has finished processing, the page function code calls OnReturn to return to the calling page.

  • OnReturn accepts a ReturnEventArgs<T> parameter, which can be used to return a value by settings the Result property. Otherwise, null can be passed to OnReturn to signify no value is returned

  • To detect when a page function has returned, the calling page can handle the Return event.

  • To return a value, the page function creates an instance of the ReturnEventArgs<T> class and sets the Result property with the return value. The calling page can retrieve this value from the ReturnEventArgs<T> object that is passed to the Return event handler.

By default, a PageFunction<T> is retained in navigation history after it returns. To ensure that it is not retained in navigation history, its RemoveFromJournal property should be set to true.

See Structured Navigation Overview for details on how to use page functions.

See Navigation Topologies Overview for information on complex navigation structures that benefit from page functions.

PageFunction<T> enables the development of wizards, which is shown in Wizard Sample.

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Media.Visual
        System.Windows.UIElement
          System.Windows.FrameworkElement
            System.Windows.Controls.Page
              System.Windows.Navigation.PageFunctionBase
                System.Windows.Navigation.PageFunction<T>

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft