AppWindow 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示应用内容的系统托管容器。
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
- 继承
- 属性
注解
重要
自 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() |
创建一个应用窗口,其中样式和属性设置为默认 |
Create(AppWindowPresenter) |
创建具有指定 |
Create(AppWindowPresenter, WindowId) |
创建一个窗口,该窗口的样式和属性在指定 |
Create(AppWindowPresenter, WindowId, DispatcherQueue) |
创建具有指定 中定义的样式和属性的窗口,这些样式和属性是指定 |
Destroy() |
尝试销毁应用窗口。 |
GetFromWindowId(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 |
在窗口被销毁时发生。 |