WaylandSeat QML 类型
提供对键盘、鼠标和触摸输入的访问。更多信息...
导入声明 | import QtWayland.Compositor |
实例化 | QWaylandSeat |
信号
- void cursorSurfaceRequest(QWaylandSurface surface, int hotspotX, int hotspotY)
- void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus)
方法
- void sendKeyEvent(int qtKey, bool pressed)
- void sendTouchCancelEvent(WaylandClient client)
- void sendTouchFrameEvent(WaylandClient client)
- void sendTouchPointMoved(WaylandSurface surface, int id, point position)
- uint sendTouchPointPressed(WaylandSurface surface, int id, point position)
- void sendTouchPointReleased(WaylandSurface surface, int id, point position)
- void sendUnicodeKeyPressEvent(uint unicode)
(自 6.7)
- void sendUnicodeKeyReleaseEvent(uint unicode)
(自 6.7)
详细说明
WaylandSeat 类型提供对不同类型用户输入的访问,并保持键盘焦点和鼠标指针。它对应于 Wayland 协议中的 wl_seat 接口。
信号文档
当客户端请求特定表面成为鼠标指针时,会发出此信号。例如,当用户悬停在特定表面上时,并希望光标变为调整大小箭头。
hotspotX和hotspotY都是从指针表面的左上角开始的偏移,其中应发生单击。例如,如果请求的鼠标指针表面是箭头,则参数表示在该表面上的箭头尖端位置。
注意:对应处理器是onCursorSurfaceRequest
。
void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus) |
在调用 setKeyboardFocus() 或当一个WaylandQuickItem 有焦点且用户开始按键时,会发出此信号。
newFocus 缓存,它表面接收到键盘焦点;如果没有任何表面有焦点,则为 nullptr
。 oldFocus 缓存,它表面丢失了键盘焦点;如果没有任何表面有焦点,则为 nullptr
。
注意: 对应的处理程序是 onKeyboardFocusChanged
。
方法文档
向键盘设备发送一个按键按下的(如果 pressed 为 true
)或释放(如果 pressed 为 false
)事件 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。
返回触摸释放事件的序列号。
|
通过一个文本输入协议发送一个键按下事件 unicode。
注意: 如果客户端不支持合成器支持的文本输入协议,则此函数可能无法正常工作。
此方法是在 Qt 6.7 中引入的。
|
通过一个文本输入协议发送一个键释放事件 unicode。
注意: 如果客户端不支持合成器支持的文本输入协议,则此函数可能无法正常工作。
此方法是在 Qt 6.7 中引入的。
© 2024 Qt公司有限公司。本文件中包含的文档贡献版权归属于各自的所有者。提供的文档遵循自由软件基金会发布的GNU自由文档许可证的条款,当前版本为1.3,可访问GNU自由文档许可证版本1.3。Qt及其相关标志是Qt公司在芬兰及全球其他国家的商标。所有其他商标均属于各自所有者。