WaylandSurface QML 类型

表示输出设备上的矩形区域。更多...

导入语句	import QtWayland.Compositor
实例化	QWaylandSurface

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

属性

bufferScale : 尺寸
bufferSize : 尺寸
client : WaylandClient
contentOrientation : 枚举
cursorSurface : 布尔
destinationSize : 尺寸
hasContent : 布尔
inhibitsIdle : 布尔
isOpaque : 布尔 (自 6.4)
origin : 枚举
sourceGeometry : 矩形
useTextureAlpha : 布尔

信号

childAdded(WaylandSurface child)
void dragStarted(WaylandDrag drag)
surfaceDestroyed()

方法

void destroy()
void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)
bool isDestroyed()

详细描述

此类封装了一个显示在输出设备上的像素矩形区域。它对应于 Wayland 协议中的接口 wl_surface。

属性文档

bufferScale : size [只读]

此属性保存了 WaylandSurface 的缓冲区缩放。缓冲区缩放允许客户端为高分辨率输出提供更高分辨率的缓冲区数据。

bufferSize : size [只读]

该属性表示这个 WaylandSurface 当前缓冲区的大稽，以像素为单位，而不是表面坐标。

对于表面坐标的大小，请使用 destinationSize。

另请参阅destinationSize 和 bufferScale。

client : WaylandClient [只读]

该属性保留正在使用此 WaylandSurface 的客户端。

contentOrientation : 枚举 [只读]

该属性保留 WaylandSurface 内容的旋转。

另请参阅WaylandOutput.transform。

cursorSurface : bool

该属性保留是否这个 WaylandSurface 是光标表面。

destinationSize : size [只读]

该属性保留这个 WaylandSurface 在表面坐标中的大小。

另请参阅bufferScale 和 bufferSize。

hasContent : bool [只读]

该属性保留 WaylandSurface 是否有内容。

inhibitsIdle : bool [只读]

该属性保留这个表面是否旨在抑制合成器的空闲行为，例如屏幕空白、锁定和屏幕保护。

另请参阅IdleInhibitManagerV1。

isOpaque : bool [只读，自6.4起]

该属性保留表面是否是完全不透明的，这是通过客户端通过 set_opaque_region 请求报告的。

该属性在 Qt 6.4 中引入。

origin : 枚举 [只读]

该属性保留 WaylandSurface 缓冲区的位置，或者如果表面没有缓冲区则为 WaylandSurface.OriginTopLeft。

它可以有以下值

WaylandSurface.OriginTopLeft 位置是缓冲区的右上角。
WaylandSurface.OriginBottomLeft 位置是缓冲区的左下角。

sourceGeometry : rect [只读]

该属性描述了应该绘制到屏幕上的附加 Wayland 缓冲区的一部分。坐标是从缓冲区角开始的比例缩放。

另请参阅bufferScale，bufferSize 和 destinationSize。

useTextureAlpha : bool

该属性指定表面是否应使用纹理 alpha。

信号文档

childAdded(WaylandSurface child)

当wl_subsurface（子surface）被添加到surface中时，会发出此信号。

注意：相应的处理程序是onChildAdded。

void dragStarted(WaylandDrag drag)

此信号在从该surface启动拖动时发出。

注意：相应的处理程序是onDragStarted。

surfaceDestroyed()

当对应的wl_surface被销毁时，会发出此信号。

注意：相应的处理程序是onSurfaceDestroyed。

方法文档

void destroy()

销毁WaylandSurface。

void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)

使用指定的compositor和client，以及指定的id和version来初始化WaylandSurface。

bool isDestroyed()

如果WaylandSurface已被销毁，则返回true。否则返回false。