Page.WindowTitle 属性

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

获取或设置 Window 的宿主 NavigationWindow 或 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

属性值

String

直接承载 Page 的窗口的标题。

属性

LocalizabilityAttribute

示例

以下示例演示如何从页面设置窗口的标题。

<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>

注解

默认情况下，承载页面的窗口的标题（包括 NavigationWindow 和 Windows Internet Explorer）是当前承载的文件的名称，如果页面是松散的 Extensible Application Markup Language (XAML) ，则为当前承载 ( (的文件的名称，如果页面是 XBAP) ) 的 XAML 浏览器应用程序的一部分，则为 .xbap 扩展名。

页面可以通过设置其 WindowTitle 属性来更改默认值。

一旦页面以这种方式设置窗口的标题，窗口的标题不会更改，直到另一个页面设置 WindowTitle 不同的值。

注意

Page必须是窗口中WindowTitle最顶层的内容才能生效;例如，如果 Page 托管在 中Frame，则 设置WindowTitle不会更改主机窗口的标题。

WindowTitle 还可用于为一段导航内容生成导航历史记录条目的名称。 以下数据片段用于按优先级顺序自动构造导航历史记录条目名称：

• 附加 Name 属性。

• Title 属性。

• 当前页 WindowTitle 的 uri) (属性和统一资源标识符

• 当前页的统一资源标识符 (URI) 。

如果已将 对象与导航历史记录中的一段内容相关联 CustomContentState ，则可以通过重写 CustomContentState.JournalEntryName来指定导航历史记录元素的名称值。