WaylandSeat QML Type
Proporciona acceso a entradas de teclado, ratón y táctiles. Más...
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandSeat |
Señales
- void cursorSurfaceRequest(QWaylandSurface surface, int hotspotX, int hotspotY)
- void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus)
Métodos
- 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)
(since 6.7) - void sendUnicodeKeyReleaseEvent(uint unicode)
(since 6.7)
Descripción detallada
El tipo WaylandSeat proporciona acceso a diferentes tipos de entrada de usuario y mantiene un foco de teclado y un puntero de ratón. Corresponde a la interfaz wl_seat del protocolo Wayland.
Documentación de señales
void cursorSurfaceRequest(QWaylandSurface surface, int hotspotX, int hotspotY)
Esta señal se emite cuando el cliente ha solicitado que un surface específico sea el cursor del ratón. Por ejemplo, cuando el usuario pasa el ratón por encima de una superficie determinada y desea que el cursor se convierta en una flecha de cambio de tamaño.
Tanto hotspotX como hotspotY son desplazamientos desde la parte superior izquierda de la superficie del puntero, donde debería producirse un clic. Por ejemplo, si la superficie del cursor solicitada es una flecha, los parámetros indican dónde está la punta de la flecha, en esa superficie.
Nota: El manejador correspondiente es onCursorSurfaceRequest.
void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus)
Esta señal se emite cuando se llama a setKeyboardFocus() o cuando un WaylandQuickItem tiene el foco y el usuario empieza a pulsar teclas.
newFocus tiene la superficie que recibió el foco del teclado; o nullptr si ninguna superficie tiene el foco. oldFocus tiene la superficie que perdió el foco del teclado; o nullptr si ninguna superficie tenía el foco.
Nota: El manejador correspondiente es onKeyboardFocusChanged.
Documentación del método
void sendKeyEvent(int qtKey, bool pressed)
Envía un evento de pulsación (si pressed es true) o liberación (si pressed es false) de una tecla qtKey al dispositivo de teclado.
void sendTouchCancelEvent(WaylandClient client)
Envía un evento de cancelación al dispositivo táctil de un client.
void sendTouchFrameEvent(WaylandClient client)
Envía un evento de marco al dispositivo táctil de un client para indicar el final de una serie de eventos de toque arriba, abajo y movimiento.
void sendTouchPointMoved(WaylandSurface surface, int id, point position)
Envía un evento de toque movido para el punto táctil id en surface con la posición position.
Nota: Necesitas enviar un evento de marco táctil cuando hayas terminado de enviar eventos táctiles.
Advertencia: Esta API no debe usarse en combinación con el reenvío de eventos de toque usando WaylandQuickItem::touchEventsEnabled, ya que podría llevar a ids de toque conflictivos.
Devuelve el serial del evento de movimiento táctil.
uint sendTouchPointPressed(WaylandSurface surface, int id, point position)
Envía un evento de toque pulsado para el punto táctil id en surface con la posición position.
Nota: Necesitas enviar un evento de marco táctil cuando hayas terminado de enviar eventos táctiles.
Advertencia: Esta API no debe utilizarse en combinación con el reenvío de eventos de toque utilizando WaylandQuickItem::touchEventsEnabled, ya que podría dar lugar a ids de toque conflictivos.
Devuelve el serial del evento de toque.
void sendTouchPointReleased(WaylandSurface surface, int id, point position)
Envía un evento de toque liberado para el punto táctil id en surface con la posición position.
Nota: Necesitas enviar un evento de marco táctil cuando hayas terminado de enviar eventos táctiles.
Advertencia: Esta API no debe utilizarse en combinación con el reenvío de eventos de toque utilizando WaylandQuickItem::touchEventsEnabled, ya que podría dar lugar a ids de toque conflictivos.
Devuelve el serial del evento de toque.
[since 6.7] void sendUnicodeKeyPressEvent(uint unicode)
Envía un evento de pulsación de tecla de un UCS4 unicode a través de un protocolo de entrada de texto.
Nota: Esta función no funcionará correctamente si el cliente no admite el protocolo de entrada de texto que admite el compositor.
Este método se introdujo en Qt 6.7.
[since 6.7] void sendUnicodeKeyReleaseEvent(uint unicode)
Envía un evento de liberación de tecla de un UCS4 unicode a través de un protocolo de entrada de texto.
Nota: Esta función no funcionará correctamente si el cliente no admite el protocolo de entrada de texto que admite el compositor.
Este método se introdujo en Qt 6.7.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.