窗口对象 QML 类型

客户端窗口表面。更多信息...

导入声明	import QtApplicationManager.SystemUI 2.0

所有成员的列表，包括继承的成员

属性

application : ApplicationObject
contentState : 枚举
popup : 布尔
requestedPopupPosition : 点
size : QSize
waylandSurface : WaylandSurface

信号

windowPropertyChanged(string name, var value)

方法

close()
var resize(Size size)
bool setWindowProperty(string name, var value)
var windowProperties()
var windowProperty(string name)

详细说明

WindowObject 表示客户端应用程序的一个窗口。应用程序侧的每个可见的 ApplicationManagerWindow 都会在服务器端，系统 UI 侧通过相应的 WindowObject 反映。

要在您的系统 UI 中渲染 WindowObject，您必须将其分配给 WindowItem。

另请参阅WindowItem。

属性文档

[只读] application : ApplicationObject

此属性包含创建此窗口的 application。

[只读] contentState : 枚举

此属性包含此窗口内容的状态。一个窗口可能由一个表面支持，而这个表面可能有内容或有内容。

WindowObject.SurfaceWithContent - 窗口由表面支持，并且该表面有内容。这是初始状态。
WindowObject.SurfaceNoContent - 窗口由表面支持，但目前该表面没有内容。它可能再次获得内容，在这种情况下，状态将返回到 WindowObject::SurfaceWithContent，或者它可能随后变为 WindowObject::NoSurface。
WindowObject.NoSurface - 窗口不再具有表面。这是一个最终状态。在显示适当的动画（如果有）后，系统 UI 应确保没有指向此 Window 的 WindowItem 实例（通过销毁它们或重置它们的 WindowItem::window 属性）来释放与其相关的资源。

如果这个窗口是对窗口系统的本地弹出窗口，则返回 true，否则返回 false。目前，只有通过Wayland的xdg-shell扩展创建的弹出窗口被认为是以本地方式创建的。

requestedPopupPosition : 点

客户端请求的本地弹出窗口的位置；对应于 QWaylandXdgPopup::configuredGeometry。

目前，只有通过Wayland的xdg-shell扩展创建的弹出窗口被认为是以本地方式创建的。在其他所有情况下，此属性返回一个空点。

另请参阅popup。

[只读] size : QSize

以像素为单位窗口表面的尺寸

另请参阅WindowObject::resize。

[只读] waylandSurface : WaylandSurface

仅在多进程模式下运行时此属性存在。它允许您访问此窗口的底层的 WaylandSurface（如果有）。当 WindowObject::contentState 为 WindowObject.NoSurface 时，此值将为空。

自然地，您应该在代码中避免使用此属性，以使代码能够在单进程和多进程模式下工作。

信号文档

windowPropertyChanged(字符串 name, var value)

通知 name 指定的窗口属性有新的 value。窗口属性更改可能是由系统 UI（通过 WindowObject::setWindowProperty）或创建该窗口的应用程序（通过 ApplicationManagerWindow::setWindowProperty）引起的。

注意：相应的处理函数是 onWindowPropertyChanged。

另请参阅setWindowProperty。

方法文档

close()

向 WindowObject 发送关闭事件。

另请参阅Window::close()。

var resize(Size size)

将 WindowObject 调整到指定的 size，以像素为单位。通常您不必自己调用此方法，因为 WindowItem 默认会处理。

另请参阅WindowObject::size 和 WindowItem::objectFollowsItemSize。

bool setWindowProperty(字符串 name, var value)

将应用程序窗口的共享属性（通过 name 标识）设置为指定的 value。当操作成功时返回 true。

这些属性在系统UI和客户端应用程序之间是共享的：在单进程模式下简单通过QVariantMap；在多进程模式下，共享是通过Qt扩展的Wayland扩展完成的。客户端的更改通过windowPropertyChanged()信号通知。

有关客户端API，请参阅ApplicationManagerWindow。

另请参阅windowProperty()、windowProperties()和windowPropertyChanged()。

var windowProperties()

返回一个对象，其中包含应用程序窗口的所有共享属性。

另请参阅setWindowProperty()。

var windowProperty(string name)

返回由name标识的应用程序窗口共享属性的值。

另请参阅setWindowProperty()。