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 11 完全支持以来，Windows 10 上部分支持标题栏自定义 API。 在调用这些 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, WindowId, DispatcherQueue)	创建一个窗口，其样式和属性在指定的 AppWindowPresenter中定义，父级为指定窗口，并与指定的 DispatcherQueue相关联。
Create(AppWindowPresenter, WindowId)	创建一个窗口，其样式和属性在指定的 AppWindowPresenter 中定义，并父级为指定窗口。
Create(AppWindowPresenter)	创建一个窗口，其样式和属性在指定的 AppWindowPresenter中定义。
Destroy()	尝试销毁应用窗口。
GetFromWindowId(WindowId)	返回具有指定 WindowId的 AppWindow（如果可用）。 如果 WindowId 无法与有效窗口匹配，则返回 null。
Hide()	隐藏系统中所有 UX 表示形式的窗口，但使对象保持活动状态。
Move(PointInt32)	将窗口移动到屏幕坐标中的指定点。
MoveAndResize(RectInt32, DisplayArea)	将窗口移动到给定显示区域中的指定点，并将其设置为指定大小。
MoveAndResize(RectInt32)	将窗口移动到屏幕坐标中的指定点，并将其设置为指定大小。
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	在销毁窗口时发生。

另请参阅

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