WaylandQuickItem QML 类型

提供了一种 Qt Quick 元素，用于表示 WaylandView。更多信息...

导入语句	import QtWayland.Compositor
实例化	QWaylandQuickItem
继承自	ShellSurfaceItem

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

属性

bufferLocked : bool
compositor : WaylandCompositor
focusOnClick : bool
origin : enum
output : WaylandOutput
paintEnabled : bool
subsurfaceHandler : object
surface : WaylandSurface
touchEventsEnabled : bool

信号

void surfaceDestroyed()

方法

point mapFromSurface(point point)
point mapToSurface(point point)
setPrimary()

详细描述

基于 Qt Quick 的 Wayland 合成器可以使用此类型在输出设备上显示客户端内容。它将用户输入传递给客户端。

属性文档

bufferLocked : bool

此属性保留是否锁定元素的缓冲区。只要缓冲区被锁定，它就不会被释放并返回给客户端。

默认值为 false。

compositor : WaylandCompositor [只读]

此属性保留由此 WaylandQuickItem 渲染的表面的合成器。

focusOnClick : bool

此属性指定当 WaylandQuickItem 被点击或触摸时，是否应该获取焦点。

默认值为 true。

origin : enum [只读]

此属性保留 QWaylandQuickItem 的起点。

输出 : WaylandOutput

此属性保存了用于显示该项目的输出。

paintEnabled : bool

如果项目隐藏了，但纹理仍然更新，则返回 true。与通过将 visible 设置为 false 来隐藏项目不同，将此属性设置为 false 将不会阻止鼠标或键盘输入到达项目。

subsurfaceHandler : object

此属性提供了一种覆盖默认子表面行为的方式。

默认情况下，Qt 将创建一个新的 SurfaceItem 作为此项目的子项，并保持正确的位置。

要覆盖默认设置，将处理程序对象分配给此属性。处理程序应实现 handleSubsurfaceAdded(WaylandSurface) 函数。

ShellSurfaceItem {
    subsurfaceHandler: QtObject {
        function handleSubsurfaceAdded(child) {
          // create custom surface item, and connect the subsurfacePositionChanged signal
        }
    }
}

此属性的默认值为 null。

surface : WaylandSurface

此属性保存由 WaylandQuickItem 渲染的表面。

touchEventsEnabled : bool

如果将触摸事件转发到客户端表面，则此属性保存 true，否则为 false。

信号文档

void surfaceDestroyed()

当客户端销毁了与 WaylandQuickItem 关联的 wl_surface 时，会发出此信号。此信号的处理器预计会立即销毁 WaylandQuickItem 或启动关闭动画，然后销毁项目。

如果启动了动画，则应将 bufferLocked 设置为确保项目在动画完成之前保持其内容。

注意：相应的处理器是 onSurfaceDestroyed。

另请参阅：bufferLocked。

方法文档

point mapFromSurface(point point)

将给定的 point 在 Wayland 表面坐标系中映射到与此项目坐标系中的等效点，并返回映射的坐标。

point mapToSurface(point point)

将给定的 point 在此项目坐标系中映射到 Wayland 表面坐标系中的等效点，并返回映射的坐标。

setPrimary()

使此 WaylandQuickItem 成为表面的主视图。