窗口对象 QML 类型

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

导入声明	import QtApplicationManager.SystemUI 2.0

包含所有成员（包括继承的成员）的列表

属性

application : ApplicationObject
contentState : 枚举
popup : bool
requestedPopupPosition : point
size : QSize
waylandSurface : WaylandSurface

信号

windowPropertyChanged(string name, var value)

方法

关闭()
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 - 窗口由一个Surface支持，但当前该Surface没有内容。它可能会再次获得内容，这样状态就会回到WindowObject::SurfaceWithContent，或者它可能会变为WindowObject::NoSurface状态。
WindowObject.NoSurface - 窗口已经没有Surface了。这是一个终止状态。在显示适当的动画后（如果有），系统UI应确保没有指向此窗口的WindowItem实例（通过销毁它们或重置它们的WindowItem::window属性）以释放与其相关的资源。

返回值为true表示此窗口是窗口系统的本地弹出窗口，否则返回false。当前，只有通过Wayland的xdg-shell扩展创建的弹出窗口被识别为本地弹出。

requestedPopupPosition : point

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

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

另请参阅popup。

size : QSize [只读]

窗口Surface的大小，以像素为单位

另请参阅WindowObject::resize。

waylandSurface : WaylandSurface [只读]

此属性仅在多进程模式下存在。允许您访问该窗口的基本WaylandSurface（如果有）。如果在WindowObject::contentState是WindowObject.NoSurface的情况下，它将为null。

您应该避免在应在单进程和多进程模式下工作时使用的代码中使用此属性。

信号文档

windowPropertyChanged(string name, var value)

通知某个名为name的窗口属性有一个新的value。窗口属性的变化可能是由系统UI（通过WindowObject::setWindowProperty）或者创建该窗口的应用程序（通过ApplicationManagerWindow::setWindowProperty）引起的。

注意：对应的处理器是onWindowPropertyChanged。

另请参阅setWindowProperty。

方法文档

关闭()

向WindowObject发送关闭事件。

另请参阅Window::close).

var resize(Size size)

将WindowObject调整到给定的size，以像素为单位。通常您不需要自己调用此方法，因为WindowItem默认会处理这个问题。

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

bool setWindowProperty(string 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()。