WaylandSeat QML Type (Uncreatable)
Permite acceder a las entradas del teclado, el ratón y la pantalla táctil. Más...
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandSeat |
Nota: Se trata de un tipo que no se puede crear. No se puede instanciar en QML.
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 permite acceder a diferentes tipos de entradas del usuario y gestiona el foco del teclado y el puntero del ratón. Se corresponde con 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 una « surface » concreta se convierta en el cursor del ratón. Por ejemplo, cuando el usuario pasa el cursor por encima de una superficie concreta y se desea que el cursor se transforme en una flecha de redimensionamiento.
Tanto ` hotspotX ` como ` hotspotY ` son desplazamientos respecto a la esquina superior izquierda de una superficie del puntero, donde debería producirse el clic. Por ejemplo, si la superficie del cursor solicitada es una flecha, los parámetros indican dónde se encuentra la punta de la flecha en dicha superficie.
Nota: El controlador correspondiente es ` onCursorSurfaceRequest`.
void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus)
Esta señal se emite cuando se llama a setKeyboardFocus() o cuando una superficie de entrada de teclado ( WaylandQuickItem ) tiene el foco y el usuario empieza a pulsar teclas.
newFocus contiene la superficie que recibió el foco del teclado; o nullptr si ninguna superficie tiene el foco. oldFocus contiene la superficie que perdió el foco del teclado; o nullptr si ninguna superficie tenía el foco.
Nota: El controlador correspondiente es onKeyboardFocusChanged.
Documentación del método
void sendKeyEvent(int qtKey, bool pressed)
Envía al dispositivo de teclado un evento de pulsación (si ` pressed ` es ` true`) o de liberación (si ` pressed ` es ` false`) de una tecla ` qtKey `.
void sendTouchCancelEvent(WaylandClient client)
Envía un evento de cancelación al dispositivo táctil de un objeto ` client`.
void sendTouchFrameEvent(WaylandClient client)
Envía un evento de fotograma al dispositivo táctil de un client para indicar el final de una serie de eventos táctiles de subida, bajada y movimiento.
void sendTouchPointMoved(WaylandSurface surface, int id, point position)
Envía un evento de desplazamiento táctil para el punto táctil id en surface con la posición position.
Nota: Debes enviar un evento de fotograma táctil cuando hayas terminado de enviar eventos táctiles.
Advertencia: Esta API no debe utilizarse junto con el reenvío de eventos táctiles mediante WaylandQuickItem::touchEventsEnabled, ya que podría provocar conflictos entre los identificadores táctiles.
Devuelve el número de serie del evento de movimiento táctil.
uint sendTouchPointPressed(WaylandSurface surface, int id, point position)
Envía un evento de pulsación táctil para el punto táctil id en surface con la posición position.
Nota: Debes enviar un evento de marco táctil cuando hayas terminado de enviar eventos táctiles.
Advertencia: Esta API no debe utilizarse junto con el reenvío de eventos táctiles mediante WaylandQuickItem::touchEventsEnabled, ya que podría dar lugar a conflictos entre los identificadores táctiles.
Devuelve el número de serie del evento de pulsación.
void sendTouchPointReleased(WaylandSurface surface, int id, point position)
Envía un evento de liberación de toque para el punto de toque id en surface con la posición position.
Nota: Debes enviar un evento de marco táctil cuando hayas terminado de enviar eventos táctiles.
Advertencia: Esta API no debe utilizarse junto con el reenvío de eventos táctiles mediante WaylandQuickItem::touchEventsEnabled, ya que podría dar lugar a conflictos entre los identificadores táctiles.
Devuelve el número de serie del evento de levantamiento del dedo.
[since 6.7] void sendUnicodeKeyPressEvent(uint unicode)
Envía un evento de pulsación de tecla de un « unicode » UCS4 a través de un protocolo de entrada de texto.
Nota: Esta función no funcionará correctamente si el cliente no es compatible con 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 « unicode » UCS4 a través de un protocolo de entrada de texto.
Nota: Esta función no funcionará correctamente si el cliente no es compatible con 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.