AppWindow 类

定义

命名空间:

Microsoft.UI.Windowing

表示应用内容的系统托管容器。

public ref class AppWindow 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 AppWindow 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 AppWindow

Public NotInheritable Class AppWindow

继承

Object Platform::Object IInspectable AppWindow

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

注解

重要

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

属性

ClientSize	获取窗口工作区的当前大小（以 Win32 客户端坐标表示）。
DispatcherQueue	获取与应用窗口关联的调度程序队列。
Id	获取应用窗口的标识符。
IsShownInSwitchers	获取或设置一个值，该值指示此窗口是否将显示在各种系统表示形式中，例如 ALT+TAB 和任务栏。
IsVisible	获取一个值，该值指示是否显示窗口。
OwnerWindowId	获取此窗口所有者的标识符;如果不是拥有，则为 0。
Position	获取窗口的当前位置（以屏幕坐标表示）。
Presenter	获取应用窗口的当前应用演示者。
Size	获取窗口的当前大小（以屏幕坐标表示）。
Title	获取或设置应用窗口的显示标题。
TitleBar	获取应用窗口的标题栏。

方法

AssociateWithDispatcherQueue(DispatcherQueue)	将应用窗口与指定的调度程序队列相关联。
Create()	创建一个应用窗口，其中样式和属性设置为默认 OverlappedPresenter的样式和属性。
Create(AppWindowPresenter)	创建具有指定 AppWindowPresenter中定义的样式和属性的窗口。
Create(AppWindowPresenter, WindowId)	创建一个窗口，该窗口的样式和属性在指定 AppWindowPresenter 窗口中定义，并且父级为指定窗口。
Create(AppWindowPresenter, WindowId, DispatcherQueue)	创建具有指定 中定义的样式和属性的窗口，这些样式和属性是指定 AppWindowPresenter窗口的父级，并且与指定的 DispatcherQueue相关联。
Destroy()	尝试销毁应用窗口。
GetFromWindowId(WindowId)	返回 AppWindow 具有指定 WindowId的 （如果可用）。 null如果 无法与有效窗口匹配，WindowId则返回 。
Hide()	隐藏系统中所有 UX 表示形式的窗口，但使对象保持活动状态。
Move(PointInt32)	将窗口移动到屏幕坐标中的指定点。
MoveAndResize(RectInt32)	将窗口移动到屏幕坐标中的指定点，并将其设置为指定大小。
MoveAndResize(RectInt32, DisplayArea)	将窗口移动到给定显示区域内的指定点，并将其设置为指定大小。
MoveInZOrderAtBottom()	将当前窗口移动到 Z 顺序中的底部窗口。
MoveInZOrderAtTop()	将当前窗口移动到 Z 顺序中的顶部窗口。
MoveInZOrderBelow(WindowId)	将当前窗口移动到 Z 顺序中的指定窗口下方。
Resize(SizeInt32)	将窗口大小调整为指定大小。
ResizeClient(SizeInt32)	调整窗口大小以适应工作区的指定大小。
SetIcon(IconId)	使用指定的图标 ID 设置窗口的图标。
SetIcon(String)	使用指定的图标路径设置窗口的图标。
SetPresenter(AppWindowPresenter)	将指定的演示者应用于窗口。
SetPresenter(AppWindowPresenterKind)	将指定的演示者类型应用于窗口。
Show()	显示窗口并激活它。
Show(Boolean)	显示窗口，其中包含用于激活该窗口的选项。
ShowOnceWithRequestedStartupState()	显示默认演示者处于请求状态的窗口。

事件

Changed	当窗口的某个属性已更改，并且系统目前处于“稳定”状态时发生。
Closing	通过系统提供关闭窗口时发生。
Destroying	在窗口被销毁时发生。

另请参阅

• 管理应用窗口
• 标题栏自定义