Page Class

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Encapsulates a page of content that can be navigated to and hosted by a browser, NavigationWindow, and Frame.

public ref class Page : System::Windows::FrameworkElement, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Content")]
public class Page : System.Windows.FrameworkElement, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Content")>]
type Page = class
    inherit FrameworkElement
    interface IAddChild

Public Class Page
Inherits FrameworkElement
Implements IAddChild

Inheritance: Object

DispatcherObject

DependencyObject

Visual

UIElement

FrameworkElement
Page

Derived: System.Windows.Navigation.PageFunctionBase

Attributes: ContentPropertyAttribute

Implements: IAddChild

Examples

The following example shows how a standard page is defined using only markup:

<Page 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    Title="Markup Page">
  <!-- Page Content Goes Here -->
</Page>

The following example shows how a standard page is defined using only code:

using System.Windows.Controls;

public class CodePage : Page
{
    public CodePage() {}
}


Imports System.Windows.Controls

Public Class CodePage
    Inherits Page
    Public Sub New()
    End Sub
End Class

The following example shows how a standard page is defined using a combination of markup and code-behind.

<Page 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="MarkupAndCodeBehindPage"
    Title="Markup And Code-Behind Page">
  <!-- Page Content Goes Here -->
</Page>

using System.Windows.Controls;

public partial class MarkupAndCodeBehindPage : Page
{
    public MarkupAndCodeBehindPage()
    {
        InitializeComponent();
    }
}


Imports System.Windows.Controls

Partial Public Class MarkupAndCodeBehindPage
    Inherits Page
    Public Sub New()
        InitializeComponent()
    End Sub
End Class

Remarks

Page encapsulates a page of content that can be navigated, and has the following key members:

Lifetime Management: KeepAlive.
Navigation: NavigationService.
Appearance: Background, Content, FontFamily, FontSize, Foreground, ShowsNavigationUI, Template, Title.
Host Window Appearance: WindowHeight, WindowWidth, WindowTitle.

A page can be defined by using markup, markup and code-behind, or code. A page is the preferred way to package content for navigation, for the following reasons:

It is easy to define, reuse, and manage.
It can access and use the NavigationService that navigated to it.
It can alter the title, width, height, and navigation UI of its host window (WindowTitle, WindowWidth, WindowHeight, ShowsNavigationUI).
It has designer support in Microsoft Visual Studio.

A page can be hosted from Window, NavigationWindow, Frame, or from a browser. To be hosted, a page can be:

The direct child of a Window, NavigationWindow, or Frame element in XAML.
Instantiated and set as the value of the Content property of Window, NavigationWindow, and Frame.
Set as the uniform resource identifier (URI) source of the Source property of either NavigationWindow or Frame.
Set as the StartupUri in a standalone application.
Set as the StartupUri in an XBAP.

An application typically has two or more pages, which can be navigated between using the following mechanisms:

Declaratively by using Hyperlink.
Programmatically by using NavigationService.
Visually by using the navigation UI of the host, including a browser, NavigationWindow, and Frame.

For structured navigation using page functions (PageFunction<T>), see Structured Navigation Overview and Navigation Topologies Overview.

Dependency properties for this control might be set by the control's default style. If a property is set by a default style, the property might change from its default value when the control appears in the application. The default style is determined by which desktop theme is used when the application is running.

Constructors

Name	Description
Page()	Initializes a new instance of the Page class.

Fields

Name	Description
BackgroundProperty	Identifies the Background dependency property.
ContentProperty	Identifies the Content dependency property.
FontFamilyProperty	Identifies the FontFamily dependency property.
FontSizeProperty	Identifies the FontSize dependency property.
ForegroundProperty	Identifies the Foreground dependency property.
KeepAliveProperty	Identifies the KeepAlive dependency property.
TemplateProperty	Identifies the Template dependency property.
TitleProperty	Identifies the Title dependency property.

Properties

Name	Description
ActualHeight	Gets the rendered height of this element. (Inherited from FrameworkElement)
ActualWidth	Gets the rendered width of this element. (Inherited from FrameworkElement)
AllowDrop	Gets or sets a value indicating whether this element can be used as the target of a drag-and-drop operation. This is a dependency property. (Inherited from UIElement)
AreAnyTouchesCaptured	Gets a value that indicates whether at least one touch is captured to this element. (Inherited from UIElement)
AreAnyTouchesCapturedWithin	Gets a value that indicates whether at least one touch is captured to this element or to any child elements in its visual tree. (Inherited from UIElement)
AreAnyTouchesDirectlyOver	Gets a value that indicates whether at least one touch is pressed over this element. (Inherited from UIElement)
AreAnyTouchesOver	Gets a value that indicates whether at least one touch is pressed over this element or any child elements in its visual tree. (Inherited from UIElement)
Background	Gets or sets the background for a Page.
BindingGroup	Gets or sets the BindingGroup that is used for the element. (Inherited from FrameworkElement)
BitmapEffect	Obsolete. Obsolete. Gets or sets a bitmap effect that applies directly to the rendered content for this element. This is a dependency property. (Inherited from UIElement)
BitmapEffectInput	Obsolete. Obsolete. Gets or sets an input source for the bitmap effect that applies directly to the rendered content for this element. This is a dependency property. (Inherited from UIElement)
CacheMode	Gets or sets a cached representation of the UIElement. (Inherited from UIElement)
Clip	Gets or sets the geometry used to define the outline of the contents of an element. This is a dependency property. (Inherited from UIElement)
ClipToBounds	Gets or sets a value indicating whether to clip the content of this element (or content coming from the child elements of this element) to fit into the size of the containing element. This is a dependency property. (Inherited from UIElement)
CommandBindings	Gets a collection of CommandBinding objects associated with this element. A CommandBinding enables command handling for this element, and declares the linkage between a command, its events, and the handlers attached by this element. (Inherited from UIElement)
Content	Gets or sets the content of a Page.
ContextMenu	Gets or sets the context menu element that should appear whenever the context menu is requested through user interface (UI) from within this element. (Inherited from FrameworkElement)
Cursor	Gets or sets the cursor that displays when the mouse pointer is over this element. (Inherited from FrameworkElement)
DataContext	Gets or sets the data context for an element when it participates in data binding. (Inherited from FrameworkElement)
DefaultStyleKey	Gets or sets the key to use to reference the style for this control, when theme styles are used or defined. (Inherited from FrameworkElement)
DependencyObjectType	Gets the DependencyObjectType that wraps the CLR type of this instance. (Inherited from DependencyObject)
DesiredSize	Gets the size that this element computed during the measure pass of the layout process. (Inherited from UIElement)
Dispatcher	Gets the Dispatcher this DispatcherObject is associated with. (Inherited from DispatcherObject)
Effect	Gets or sets the bitmap effect to apply to the UIElement. This is a dependency property. (Inherited from UIElement)
FlowDirection	Gets or sets the direction that text and other user interface (UI) elements flow within any parent element that controls their layout. (Inherited from FrameworkElement)
Focusable	Gets or sets a value that indicates whether the element can receive focus. This is a dependency property. (Inherited from UIElement)
FocusVisualStyle	Gets or sets a property that enables customization of appearance, effects, or other style characteristics that will apply to this element when it captures keyboard focus. (Inherited from FrameworkElement)
FontFamily	Gets or sets the name of the specified font family.
FontSize	Gets or sets the font size.
ForceCursor	Gets or sets a value that indicates whether this FrameworkElement should force the user interface (UI) to render the cursor as declared by the Cursor property. (Inherited from FrameworkElement)
Foreground	Gets or sets the foreground for a Page.
HasAnimatedProperties	Gets a value indicating whether this element has any animated properties. (Inherited from UIElement)
HasEffectiveKeyboardFocus	Gets a value that indicates whether the UIElement has focus. (Inherited from UIElement)
Height	Gets or sets the suggested height of the element. (Inherited from FrameworkElement)
HorizontalAlignment	Gets or sets the horizontal alignment characteristics applied to this element when it is composed within a parent element, such as a panel or items control. (Inherited from FrameworkElement)
InheritanceBehavior	Gets or sets the scope limits for property value inheritance, resource key lookup, and RelativeSource FindAncestor lookup. (Inherited from FrameworkElement)
InputBindings	Gets the collection of input bindings associated with this element. (Inherited from UIElement)
InputScope	Gets or sets the context for input used by this FrameworkElement. (Inherited from FrameworkElement)
IsArrangeValid	Gets a value indicating whether the computed size and position of child elements in this element's layout are valid. (Inherited from UIElement)
IsEnabled	Gets or sets a value indicating whether this element is enabled in the user interface (UI). This is a dependency property. (Inherited from UIElement)
IsEnabledCore	Gets a value that becomes the return value of IsEnabled in derived classes. (Inherited from UIElement)
IsFocused	Gets a value that determines whether this element has logical focus. This is a dependency property. (Inherited from UIElement)
IsHitTestVisible	Gets or sets a value that declares whether this element can possibly be returned as a hit test result from some portion of its rendered content. This is a dependency property. (Inherited from UIElement)
IsInitialized	Gets a value that indicates whether this element has been initialized, either during processing by a XAML processor, or by explicitly having its EndInit() method called. (Inherited from FrameworkElement)
IsInputMethodEnabled	Gets a value indicating whether an input method system, such as an Input Method Editor (IME), is enabled for processing the input to this element. (Inherited from UIElement)
IsKeyboardFocused	Gets a value indicating whether this element has keyboard focus. This is a dependency property. (Inherited from UIElement)
IsKeyboardFocusWithin	Gets a value indicating whether keyboard focus is anywhere within the element or its visual tree child elements. This is a dependency property. (Inherited from UIElement)
IsLoaded	Gets a value that indicates whether this element has been loaded for presentation. (Inherited from FrameworkElement)
IsManipulationEnabled	Gets or sets a value that indicates whether manipulation events are enabled on this UIElement. (Inherited from UIElement)
IsMeasureValid	Gets a value indicating whether the current size returned by layout measure is valid. (Inherited from UIElement)
IsMouseCaptured	Gets a value indicating whether the mouse is captured to this element. This is a dependency property. (Inherited from UIElement)
IsMouseCaptureWithin	Gets a value that determines whether mouse capture is held by this element or by child elements in its visual tree. This is a dependency property. (Inherited from UIElement)
IsMouseDirectlyOver	Gets a value that indicates whether the position of the mouse pointer corresponds to hit test results, which take element compositing into account. This is a dependency property. (Inherited from UIElement)
IsMouseOver	Gets a value indicating whether the mouse pointer is located over this element (including child elements in the visual tree). This is a dependency property. (Inherited from UIElement)
IsSealed	Gets a value that indicates whether this instance is currently sealed (read-only). (Inherited from DependencyObject)
IsStylusCaptured	Gets a value indicating whether the stylus is captured by this element. This is a dependency property. (Inherited from UIElement)
IsStylusCaptureWithin	Gets a value that determines whether stylus capture is held by this element, or an element within the element bounds and its visual tree. This is a dependency property. (Inherited from UIElement)
IsStylusDirectlyOver	Gets a value that indicates whether the stylus position corresponds to hit test results, which take element compositing into account. This is a dependency property. (Inherited from UIElement)
IsStylusOver	Gets a value indicating whether the stylus cursor is located over this element (including visual child elements). This is a dependency property. (Inherited from UIElement)
IsVisible	Gets a value indicating whether this element is visible in the user interface (UI). This is a dependency property. (Inherited from UIElement)
KeepAlive	Gets or sets a value that indicates whether the Page instance is retained in navigation history.
Language	Gets or sets localization/globalization language information that applies to an element. (Inherited from FrameworkElement)
LayoutTransform	Gets or sets a graphics transformation that should apply to this element when layout is performed. (Inherited from FrameworkElement)
LogicalChildren	Returns an enumerator for the logical child elements of a Page.
Margin	Gets or sets the outer margin of an element. (Inherited from FrameworkElement)
MaxHeight	Gets or sets the maximum height constraint of the element. (Inherited from FrameworkElement)
MaxWidth	Gets or sets the maximum width constraint of the element. (Inherited from FrameworkElement)
MinHeight	Gets or sets the minimum height constraint of the element. (Inherited from FrameworkElement)
MinWidth	Gets or sets the minimum width constraint of the element. (Inherited from FrameworkElement)
Name	Gets or sets the identifying name of the element. The name provides a reference so that code-behind, such as event handler code, can refer to a markup element after it is constructed during processing by a XAML processor. (Inherited from FrameworkElement)
NavigationService	Gets the navigation service that the host of the page is using to manage navigation.
Opacity	Gets or sets the opacity factor applied to the entire UIElement when it is rendered in the user interface (UI). This is a dependency property. (Inherited from UIElement)
OpacityMask	Gets or sets an opacity mask, as a Brush implementation that is applied to any alpha-channel masking for the rendered content of this element. This is a dependency property. (Inherited from UIElement)
OverridesDefaultStyle	Gets or sets a value that indicates whether this element incorporates style properties from theme styles. (Inherited from FrameworkElement)
Parent	Gets the logical parent element of this element. (Inherited from FrameworkElement)
PersistId	Obsolete. Gets a value that uniquely identifies this element. (Inherited from UIElement)
RenderSize	Gets (or sets) the final render size of this element. (Inherited from UIElement)
RenderTransform	Gets or sets transform information that affects the rendering position of this element. This is a dependency property. (Inherited from UIElement)
RenderTransformOrigin	Gets or sets the center point of any possible render transform declared by RenderTransform, relative to the bounds of the element. This is a dependency property. (Inherited from UIElement)
Resources	Gets or sets the locally-defined resource dictionary. (Inherited from FrameworkElement)
ShowsNavigationUI	Gets or sets a value that indicates whether the navigation UI of a NavigationWindow on Microsoft Internet Explorer 6 is visible.
SnapsToDevicePixels	Gets or sets a value that determines whether rendering for this element should use device-specific pixel settings during rendering. This is a dependency property. (Inherited from UIElement)
Style	Gets or sets the style used by this element when it is rendered. (Inherited from FrameworkElement)
StylusPlugIns	Gets a collection of all stylus plug-in (customization) objects associated with this element. (Inherited from UIElement)
Tag	Gets or sets an arbitrary object value that can be used to store custom information about this element. (Inherited from FrameworkElement)
Template	Gets or sets the control template for a Page.
TemplatedParent	Gets a reference to the template parent of this element. This property is not relevant if the element was not created through a template. (Inherited from FrameworkElement)
Title	Gets or sets the title of the Page.
ToolTip	Gets or sets the tool-tip object that is displayed for this element in the user interface (UI). (Inherited from FrameworkElement)
TouchesCaptured	Gets all touch devices that are captured to this element. (Inherited from UIElement)
TouchesCapturedWithin	Gets all touch devices that are captured to this element or any child elements in its visual tree. (Inherited from UIElement)
TouchesDirectlyOver	Gets all touch devices that are over this element. (Inherited from UIElement)
TouchesOver	Gets all touch devices that are over this element or any child elements in its visual tree. (Inherited from UIElement)
Triggers	Gets the collection of triggers established directly on this element, or in child elements. (Inherited from FrameworkElement)
Uid	Gets or sets the unique identifier (for localization) for this element. This is a dependency property. (Inherited from UIElement)
UseLayoutRounding	Gets or sets a value that indicates whether layout rounding should be applied to this element's size and position during layout. (Inherited from FrameworkElement)
VerticalAlignment	Gets or sets the vertical alignment characteristics applied to this element when it is composed within a parent element such as a panel or items control. (Inherited from FrameworkElement)
Visibility	Gets or sets the user interface (UI) visibility of this element. This is a dependency property. (Inherited from UIElement)
VisualBitmapEffect	Obsolete. Obsolete. Gets or sets the BitmapEffect value for the Visual. (Inherited from Visual)
VisualBitmapEffectInput	Obsolete. Obsolete. Gets or sets the BitmapEffectInput value for the Visual. (Inherited from Visual)
VisualBitmapScalingMode	Gets or sets the BitmapScalingMode for the Visual. (Inherited from Visual)
VisualCacheMode	Gets or sets a cached representation of the Visual. (Inherited from Visual)
VisualChildrenCount	Gets the number of visual child elements within this element. (Inherited from FrameworkElement)
VisualClearTypeHint	Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual. (Inherited from Visual)
VisualClip	Gets or sets the clip region of the Visual as a Geometry value. (Inherited from Visual)
VisualEdgeMode	Gets or sets the edge mode of the Visual as an EdgeMode value. (Inherited from Visual)
VisualEffect	Gets or sets the bitmap effect to apply to the Visual. (Inherited from Visual)
VisualOffset	Gets or sets the offset value of the visual object. (Inherited from Visual)
VisualOpacity	Gets or sets the opacity of the Visual. (Inherited from Visual)
VisualOpacityMask	Gets or sets the Brush value that represents the opacity mask of the Visual. (Inherited from Visual)
VisualParent	Gets the visual tree parent of the visual object. (Inherited from Visual)
VisualScrollableAreaClip	Gets or sets a clipped scrollable area for the Visual. (Inherited from Visual)
VisualTextHintingMode	Gets or sets the TextHintingMode of the Visual. (Inherited from Visual)
VisualTextRenderingMode	Gets or sets the TextRenderingMode of the Visual. (Inherited from Visual)
VisualTransform	Gets or sets the Transform value for the Visual. (Inherited from Visual)
VisualXSnappingGuidelines	Gets or sets the x-coordinate (vertical) guideline collection. (Inherited from Visual)
VisualYSnappingGuidelines	Gets or sets the y-coordinate (horizontal) guideline collection. (Inherited from Visual)
Width	Gets or sets the width of the element. (Inherited from FrameworkElement)
WindowHeight	Gets or sets the height of the host Window or NavigationWindow of a Page.
WindowTitle	Gets or sets the title of the host Window or NavigationWindow of a Page.
WindowWidth	Gets or sets the width of the host Window or NavigationWindow of a Page.

Methods

Name	Description
AddHandler(RoutedEvent, Delegate, Boolean)	Adds a routed event handler for a specified routed event, adding the handler to the handler collection on the current element. Specify `handledEventsToo` as `true` to have the provided handler be invoked for routed event that had already been marked as handled by another element along the event route. (Inherited from UIElement)
AddHandler(RoutedEvent, Delegate)	Adds a routed event handler for a specified routed event, adding the handler to the handler collection on the current element. (Inherited from UIElement)
AddLogicalChild(Object)	Adds the provided object to the logical tree of this element. (Inherited from FrameworkElement)
AddToEventRoute(EventRoute, RoutedEventArgs)	Adds handlers to the specified EventRoute for the current UIElement event handler collection. (Inherited from UIElement)
AddVisualChild(Visual)	Defines the parent-child relationship between two visuals. (Inherited from Visual)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Applies an animation to a specified dependency property on this element, with the ability to specify what happens if the property already has a running animation. (Inherited from UIElement)