Page.WindowTitle Property

Reference

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.

Gets or sets the title of the host Window or NavigationWindow of a Page.

public:
 property System::String ^ WindowTitle { System::String ^ get(); void set(System::String ^ value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.Title)]
public string WindowTitle { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Title)>]
member this.WindowTitle : string with get, set

Public Property WindowTitle As String

Property Value

String

The title of a window that directly hosts the Page.

Attributes: LocalizabilityAttribute

Examples

The following example shows how to set the title of a window from a page.

<Page
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    Title="Page Title"
    WindowTitle="Window Title"
    >
</Page>

Remarks

By default, the title of a window that hosts a page, including NavigationWindow and Windows Internet Explorer, is the name of the file that is currently being hosted (with an .xaml extension if the page is loose Extensible Application Markup Language (XAML), or an .xbap extension if the page is part of an XAML browser application (XBAP)).

A page can change the default by setting its WindowTitle property.

Once a page sets the title of a window in this way, the window's title does not change until another page sets WindowTitle with a different value.

Note

The Page must be the topmost piece of content in a window for WindowTitle to have an effect; if a Page is hosted within a Frame, for example, setting WindowTitle does not change the title of the host window.

WindowTitle can also be used to generate the name of the navigation history entry for a piece of navigated content. The following pieces of data are used to automatically construct a navigation history entry name, in order of precedence:

The attached Name attribute.
The Title property.
The WindowTitle property and the uniform resource identifier (URI) for the current page
The uniform resource identifier (URI) for the current page.

If you have associated a CustomContentState object with a piece of content in navigation history, you can specify the name value of a navigation history element by overriding CustomContentState.JournalEntryName.

Applies to

Share via