AppWindowTitleBar 类

定义

命名空间:

Microsoft.UI.Windowing

表示应用窗口的标题栏。

public ref class AppWindowTitleBar sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppWindowTitleBar final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppWindowTitleBar

Public NotInheritable Class AppWindowTitleBar

继承

Object Platform::Object IInspectable AppWindowTitleBar

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

注解

重要

自 Windows 应用 SDK 1.2 以来，Windows 10部分支持标题栏自定义 API，Windows 11完全支持。 在调用这些 API 之前，应在代码中检查 AppWindowTitleBar.IsCustomizationSupported，以确保你的应用不会在其他版本的 Windows 上崩溃。 有关详细信息 ，请参阅标题栏自定义 。

属性

BackgroundColor	获取或设置标题栏背景的颜色。
ButtonBackgroundColor	获取或设置标题栏按钮的背景色。
ButtonForegroundColor	获取或设置标题栏按钮的前景色。
ButtonHoverBackgroundColor	获取或设置指针位于标题栏按钮上时的背景色。
ButtonHoverForegroundColor	获取或设置指针位于标题栏按钮上时的前景色。
ButtonInactiveBackgroundColor	获取或设置处于非活动状态的标题栏按钮的背景色。
ButtonInactiveForegroundColor	获取或设置标题栏按钮处于非活动状态时的前景色。
ButtonPressedBackgroundColor	获取或设置按下标题栏按钮时的背景色。
ButtonPressedForegroundColor	获取或设置按下标题栏按钮时它的前景色。
ExtendsContentIntoTitleBar	获取或设置一个值，该值指定应用内容是否扩展到标题栏区域。
ForegroundColor	获取或设置标题栏前景的颜色。
Height	获取标题栏的高度（以客户端坐标表示）。
IconShowOptions	获取或设置一个值，该值指定窗口图标在标题栏中的显示方式。
InactiveBackgroundColor	获取或设置处于非活动状态时标题栏背景的颜色。
InactiveForegroundColor	获取或设置处于非活动状态时标题栏前景的颜色。
LeftInset	获取应用窗口左上角的系统保留区域的宽度。
PreferredHeightOption	获取或设置一个值，该值指定当 属性为 true时AppWindowTitleBar.ExtendsContentIntoTitleBar标题栏的高度选项。
RightInset	获取应用窗口右上角的系统保留区域的宽度。

方法

IsCustomizationSupported()	获取一个值，该值指示是否可以自定义标题栏。
ResetToDefault()	将当前标题栏重置回窗口的默认设置。
SetDragRectangles(RectInt32[])	为窗口设置拖动区域。

另请参阅

• 标题栏自定义