WaylandSeat QML 类型

提供对键盘、鼠标和触摸输入的访问。更多信息...

导入声明import QtWayland.Compositor
实例化 QWaylandSeat

信号

方法

详细说明

WaylandSeat 类型提供对不同类型用户输入的访问,并保持键盘焦点和鼠标指针。它对应于 Wayland 协议中的 wl_seat 接口。

信号文档

void cursorSurfaceRequest(QWaylandSurface surface, int hotspotX, int hotspotY)

当客户端请求特定表面成为鼠标指针时,会发出此信号。例如,当用户悬停在特定表面上时,并希望光标变为调整大小箭头。

hotspotXhotspotY都是从指针表面的左上角开始的偏移,其中应发生单击。例如,如果请求的鼠标指针表面是箭头,则参数表示在该表面上的箭头尖端位置。

注意:对应处理器是onCursorSurfaceRequest


void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus)

在调用 setKeyboardFocus() 或当一个WaylandQuickItem 有焦点且用户开始按键时,会发出此信号。

newFocus 缓存,它表面接收到键盘焦点;如果没有任何表面有焦点,则为 nullptroldFocus 缓存,它表面丢失了键盘焦点;如果没有任何表面有焦点,则为 nullptr

注意: 对应的处理程序是 onKeyboardFocusChanged


方法文档

void sendKeyEvent(int qtKey, bool pressed)

向键盘设备发送一个按键按下的(如果 pressedtrue)或释放(如果 pressedfalse)事件 qtKey


void sendTouchCancelEvent(WaylandClient client)

client 的触摸设备发送一个取消事件。


void sendTouchFrameEvent(WaylandClient client)

client 的触摸设备发送一个帧事件,以指示一系列触摸抬起、按下和移动事件的结束。


void sendTouchPointMoved(WaylandSurface surface, int id, point position)

surface 上的触摸点 id 发送一个触 Moved 事件,带有 position 位置。

注意: 在发送完触摸事件后,您需要发送一个帧事件。

警告: 如果使用 WaylandQuickItem::touchEventsEnabled 前向转发触摸事件,则不应使用此 API,因为它可能会导致冲突的触摸 ID。

返回触摸移动事件的序列号。


uint sendTouchPointPressed(WaylandSurface surface, int id, point position)

surface 上的 id 处位置 position 的触摸点 id 发送触摸按下事件。

注意: 在发送完触摸事件后,您需要发送一个帧事件。

警告: 如果使用 WaylandQuickItem::touchEventsEnabled 前向转发触摸事件,则不应使用此 API,因为它可能会导致冲突的触摸 ID。

返回触摸按下事件的序列号。


void sendTouchPointReleased(WaylandSurface surface, int id, point position)

surface 上的 id 处位置 position 的触摸点 id 发送触摸释放事件。

注意: 在发送完触摸事件后,您需要发送一个帧事件。

警告: 如果使用 WaylandQuickItem::touchEventsEnabled 前向转发触摸事件,则不应使用此 API,因为它可能会导致冲突的触摸 ID。

返回触摸释放事件的序列号。


[since 6.7] void sendUnicodeKeyPressEvent(uint unicode)

通过一个文本输入协议发送一个键按下事件 unicode

注意: 如果客户端不支持合成器支持的文本输入协议,则此函数可能无法正常工作。

此方法是在 Qt 6.7 中引入的。


[since 6.7] void sendUnicodeKeyReleaseEvent(uint unicode)

通过一个文本输入协议发送一个键释放事件 unicode

注意: 如果客户端不支持合成器支持的文本输入协议,则此函数可能无法正常工作。

此方法是在 Qt 6.7 中引入的。


© 2024 Qt公司有限公司。本文件中包含的文档贡献版权归属于各自的所有者。提供的文档遵循自由软件基金会发布的GNU自由文档许可证的条款,当前版本为1.3,可访问GNU自由文档许可证版本1.3。Qt及其相关标志是Qt公司在芬兰及全球其他国家的商标。所有其他商标均属于各自所有者。