Window.Title 属性

定义

获取或设置用于窗口标题的字符串。

public:
 property Platform::String ^ Title { Platform::String ^ get(); void set(Platform::String ^ value); };
winrt::hstring Title();

void Title(winrt::hstring value);
public string Title { get; set; }
var string = window.title;
window.title = string;
Public Property Title As String

属性值

String

Platform::String

winrt::hstring

用于窗口标题的字符串。

示例

此示例演示如何在代码中设置 Title。

public MainWindow()
{
    InitializeComponent();
    Title = "App title";
}

XAML 应用具有在文件 Package.appxmanifest 中设置的显示名称。 可以获取此值,并使用它来设置 Title 如下所示的属性:

Title = AppInfo.Current.DisplayInfo.DisplayName;

注释

在 Windows 应用 SDK 1.3.0 及更早版本中,Title在 XAML IntelliSense Window中显示,但在 XAML 中设置会导致错误。 请改为在代码中设置此属性。 在 Windows 应用 SDK 1.3.1 及更高版本中,可以在 XAML 中设置此属性。

<Window
    ...
    Title="App title">
    ...
</Window>

注解

有关详细信息,请参阅标题栏自定义

默认情况下,标题栏将应用类型显示为窗口标题(例如“WinUI Desktop”)。 你应更新窗口标题以显示应用的有意义显示名称。

若要将标题替换为自定义文本,请将 Window.Title 属性设置为文本值,如“示例”中所示。

除了标题栏,此字符串还用于其他系统 UI,例如应用程序切换器(Alt-Tab)。

这是 SetWindowText 的包装器。

如果 ExtendsContentIntoTitleBar 设置为 true,则标题栏不会显示此值。

适用于

另请参阅