QWaylandSeat Class
La clase QWaylandSeat permite acceder a las entradas de teclado, ratón y táctiles. Más información...
| Encabezado: | #include <QWaylandSeat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| En QML: | WaylandSeat |
| Heredan de: | QWaylandObject |
Tipos públicos
| enum | CapabilityFlag { Pointer, Keyboard, Touch, DefaultCapabilities } |
| flags | CapabilityFlags |
Propiedades
Funciones públicas
| QWaylandSeat(QWaylandCompositor *compositor, QWaylandSeat::CapabilityFlags capabilityFlags = DefaultCapabilities) | |
| virtual | ~QWaylandSeat() override |
| QWaylandSeat::CapabilityFlags | capabilities() const |
| QWaylandCompositor * | compositor() const |
| QWaylandDrag * | drag() const |
| virtual void | initialize() |
| bool | isInitialized() const |
| QWaylandKeyboard * | keyboard() const |
| QWaylandSurface * | keyboardFocus() const |
| QWaylandKeymap * | keymap() |
| QWaylandView * | mouseFocus() const |
| QWaylandPointer * | pointer() const |
| void | sendFullKeyEvent(QKeyEvent *event) |
| void | sendFullTouchEvent(QWaylandSurface *surface, QTouchEvent *event) |
| void | sendKeyEvent(int qtKey, bool pressed) |
| void | sendKeyPressEvent(uint code) |
| void | sendKeyReleaseEvent(uint code) |
| void | sendMouseMoveEvent(QWaylandView *view, const QPointF &localPos, const QPointF &outputSpacePos = QPointF()) |
| void | sendMousePressEvent(Qt::MouseButton button) |
| void | sendMouseReleaseEvent(Qt::MouseButton button) |
| void | sendMouseWheelEvent(Qt::Orientation orientation, int delta) |
| void | sendTouchCancelEvent(QWaylandClient *client) |
| void | sendTouchFrameEvent(QWaylandClient *client) |
| uint | sendTouchPointEvent(QWaylandSurface *surface, int id, const QPointF &point, Qt::TouchPointState state) |
| uint | sendTouchPointMoved(QWaylandSurface *surface, int id, const QPointF &position) |
| uint | sendTouchPointPressed(QWaylandSurface *surface, int id, const QPointF &position) |
| uint | sendTouchPointReleased(QWaylandSurface *surface, int id, const QPointF &position) |
(since 6.7) void | sendUnicodeKeyPressEvent(uint unicode) |
(since 6.7) void | sendUnicodeKeyReleaseEvent(uint unicode) |
| bool | setKeyboardFocus(QWaylandSurface *surface) |
| void | setMouseFocus(QWaylandView *view) |
| QWaylandTouch * | touch() const |
Señales
| void | cursorSurfaceRequest(QWaylandSurface *surface, int hotspotX, int hotspotY) |
| void | keyboardFocusChanged(QWaylandSurface *newFocus, QWaylandSurface *oldFocus) |
| void | mouseFocusChanged(QWaylandView *newFocus, QWaylandView *oldFocus) |
Miembros públicos estáticos
| QWaylandSeat * | fromSeatResource(struct wl_resource *resource) |
Descripción detallada
QWaylandSeat proporciona acceso a diferentes tipos de entrada 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 sobre los tipos de miembros
enum QWaylandSeat::CapabilityFlag
flags QWaylandSeat::CapabilityFlags
Este tipo de enumeración describe las capacidades de un « QWaylandSeat ».
| Constante | Valor | Descripción |
|---|---|---|
QWaylandSeat::Pointer | 0x01 | El « QWaylandSeat » admite la entrada mediante puntero. |
QWaylandSeat::Keyboard | 0x02 | El « QWaylandSeat » admite la entrada mediante teclado. |
QWaylandSeat::Touch | 0x04 | El « QWaylandSeat » admite la entrada táctil. |
QWaylandSeat::DefaultCapabilities | Pointer | Keyboard | Touch | El ` QWaylandSeat ` tiene las capacidades predeterminadas. |
El tipo CapabilityFlags es un typedef para QFlags<CapabilityFlag>. Almacena una combinación OR de valores de CapabilityFlag.
Documentación de la propiedad
[read-only] drag : QWaylandDrag* const
Esta propiedad gestiona las operaciones de arrastrar y soltar y envía señales cuando estas comienzan y finalizan. La propiedad almacena detalles como qué imagen debe aparecer debajo del cursor del ratón cuando el usuario la arrastra.
Funciones de acceso:
| QWaylandDrag * | drag() const |
[read-only] keymap : QWaylandKeymap* const
Esta propiedad contiene el objeto de mapa de teclas.
Un mapa de teclas permite convertir los códigos de escaneo reales de las teclas en un valor significativo. Por ejemplo, si utilizas un mapa de teclas con una distribución noruega, la tecla situada a la derecha de la letra L genera un Ø.
Los mapas de teclas también se pueden utilizar para personalizar las funciones de las teclas, como por ejemplo para especificar si se deben intercambiar las teclas Control y Bloq Mayús, entre otras cosas.
Funciones de acceso:
| QWaylandKeymap * | keymap() |
Documentación de funciones de miembro
QWaylandSeat::QWaylandSeat(QWaylandCompositor *compositor, QWaylandSeat::CapabilityFlags capabilityFlags = DefaultCapabilities)
Crea un objeto `QWaylandSeat` a partir de los valores ` compositor ` y ` capabilityFlags` proporcionados.
[override virtual noexcept] QWaylandSeat::~QWaylandSeat()
Destruye el QWaylandSeat
QWaylandSeat::CapabilityFlags QWaylandSeat::capabilities() const
Devuelve los indicadores de capacidades de este QWaylandSeat.
QWaylandCompositor *QWaylandSeat::compositor() const
Devuelve el compositor de este QWaylandSeat.
[signal] void QWaylandSeat::cursorSurfaceRequest(QWaylandSurface *surface, int hotspotX, int hotspotY)
Esta señal se emite cuando el cliente ha solicitado que un « surface » específico se convierta en el cursor del ratón. Por ejemplo, cuando el usuario pasa el ratón 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.
QWaylandDrag *QWaylandSeat::drag() const
Devuelve el objeto de arrastre correspondiente a este ` QWaylandSeat`.
Nota: Funcióngetter para la propiedad drag.
[static] QWaylandSeat *QWaylandSeat::fromSeatResource(struct wl_resource *resource)
Devuelve el objeto « QWaylandSeat » correspondiente al objeto « resource ». Se espera que el objeto « resource » sea de tipo «wl_seat».
[virtual] void QWaylandSeat::initialize()
Inicializa las partes del asiento que corresponden a las capacidades establecidas en el constructor o mediante setCapabilities().
Nota: Normalmente , esta función se invoca automáticamente tras la creación del asiento y del compositor, por lo que no suele ser necesario invocarla manualmente.
bool QWaylandSeat::isInitialized() const
Devuelve «true» si se ha inicializado el « QWaylandSeat »; en caso contrario, devuelve «false».
El valor « true » indica que los clientes ya pueden empezar a utilizar la licencia.
QWaylandKeyboard *QWaylandSeat::keyboard() const
Devuelve el teclado asociado a este dispositivo de entrada.
QWaylandSurface *QWaylandSeat::keyboardFocus() const
Devuelve la superficie que tiene el foco actualmente para la entrada del teclado.
Véase también setKeyboardFocus().
[signal] void QWaylandSeat::keyboardFocusChanged(QWaylandSurface *newFocus, QWaylandSurface *oldFocus)
Esta señal se emite cuando se invoca a ` setKeyboardFocus()`.
newFocus contiene la superficie que recibió el foco del teclado; o bien nullptr si ninguna superficie tiene el foco. oldFocus contiene la superficie que perdió el foco del teclado; o bien nullptr si ninguna superficie tenía el foco.
QWaylandKeymap *QWaylandSeat::keymap()
Devuelve el objeto de mapa de teclas correspondiente a este ` QWaylandSeat`.
Nota: Funcióngetter para la propiedad keymap.
QWaylandView *QWaylandSeat::mouseFocus() const
Devuelve la vista que tiene actualmente el foco del ratón.
Véase también setMouseFocus().
[signal] void QWaylandSeat::mouseFocusChanged(QWaylandView *newFocus, QWaylandView *oldFocus)
Esta señal se emite cuando el foco del ratón ha pasado de oldFocus a newFocus.
QWaylandPointer *QWaylandSeat::pointer() const
Devuelve el dispositivo de puntero correspondiente a este ` QWaylandSeat`.
void QWaylandSeat::sendFullKeyEvent(QKeyEvent *event)
Envía el « event » al dispositivo de teclado.
Nota: El « event » debe corresponder a una tecla real del teclado en la asignación actual. Por ejemplo, Qt::Key_Exclam no suele ser una tecla independiente: en la mayoría de los teclados, el signo de exclamación se introduce con Shift + 1. En ese caso, para enviar un evento de pulsación de la tecla del signo de exclamación, utiliza QKeyEvent(QEvent::KeyPress, Qt::Key_1, Qt::ShiftModifier).
void QWaylandSeat::sendFullTouchEvent(QWaylandSurface *surface, QTouchEvent *event)
Envía el ` event ` a la dirección ` surface ` especificada en el dispositivo táctil.
Advertencia: Esta API asignará automáticamente un identificador secuencial a QEventPoint::id() antes de enviarlo al cliente. Por lo tanto, no debe utilizarse junto con la otra API que utiliza identificadores explícitos, ya que podrían producirse colisiones.
[invokable] void QWaylandSeat::sendKeyEvent(int qtKey, bool pressed)
Envía al dispositivo de teclado un evento de pulsación (si pressed es true) o de suelta (si pressed es false) de una tecla qtKey.
Nota: Esta función no admite eventos de tecla que requieran modificadores, como Qt::Key_Exclam. Utiliza sendFullKeyEvent en su lugar.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
void QWaylandSeat::sendKeyPressEvent(uint code)
Envía un evento de pulsación de tecla con la clave « code » al dispositivo de teclado.
void QWaylandSeat::sendKeyReleaseEvent(uint code)
Envía un evento de liberación de tecla con la clave « code » al dispositivo de teclado.
void QWaylandSeat::sendMouseMoveEvent(QWaylandView *view, const QPointF &localPos, const QPointF &outputSpacePos = QPointF())
Establece el foco del ratón en view y envía un evento de movimiento del ratón al dispositivo puntero con la posición local localPos y la posición en el espacio de salida outputSpacePos.
void QWaylandSeat::sendMousePressEvent(Qt::MouseButton button)
Envía un evento de pulsación del ratón para « button » al dispositivo de puntero de « QWaylandSeat ».
void QWaylandSeat::sendMouseReleaseEvent(Qt::MouseButton button)
Envía un evento de liberación del ratón para button al dispositivo de puntero de QWaylandSeat.
void QWaylandSeat::sendMouseWheelEvent(Qt::Orientation orientation, int delta)
Envía un evento de rueda del ratón al dispositivo puntero de QWaylandSeat con los valores indicados de orientation y delta.
[invokable] void QWaylandSeat::sendTouchCancelEvent(QWaylandClient *client)
Envía un evento de cancelación al dispositivo táctil de un ` client`.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QWaylandSeat::sendTouchFrameEvent(QWaylandClient *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.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
uint QWaylandSeat::sendTouchPointEvent(QWaylandSurface *surface, int id, const QPointF &point, Qt::TouchPointState state)
Envía un evento de punto táctil al surface en un dispositivo táctil con los valores indicados para id, point y state.
Advertencia: Esta API no debe utilizarse junto con el reenvío de eventos táctiles mediante QWaylandQuickItem::touchEventsEnabled o sendFullTouchEvent, ya que podría provocar conflictos entre los identificadores táctiles.
Devuelve el número de serie del evento de levantamiento o de contacto.
[invokable] uint QWaylandSeat::sendTouchPointMoved(QWaylandSurface *surface, int id, const QPointF &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 QWaylandQuickItem::touchEventsEnabled o sendFullTouchEvent, ya que podría provocar conflictos entre los identificadores táctiles.
Devuelve el número de serie del evento de movimiento táctil.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] uint QWaylandSeat::sendTouchPointPressed(QWaylandSurface *surface, int id, const QPointF &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 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 QWaylandQuickItem::touchEventsEnabled o sendFullTouchEvent, ya que podría provocar conflictos entre los identificadores táctiles.
Devuelve el número de serie del evento de pulsación.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] uint QWaylandSeat::sendTouchPointReleased(QWaylandSurface *surface, int id, const QPointF &position)
Envía un evento de liberación de toque para el punto de contacto 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 QWaylandQuickItem::touchEventsEnabled o sendFullTouchEvent, ya que podría provocar conflictos entre los identificadores táctiles.
Devuelve el número de serie del evento de levantamiento del dedo.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable, since 6.7] void QWaylandSeat::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.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Esta función se introdujo en Qt 6.7.
Véase también sendKeyEvent.
[invokable, since 6.7] void QWaylandSeat::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.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Esta función se introdujo en Qt 6.7.
Véase también sendKeyEvent.
bool QWaylandSeat::setKeyboardFocus(QWaylandSurface *surface)
Establece el foco del teclado actual en surface. Devuelve un valor booleano que indica si la operación se ha realizado correctamente.
Véase también keyboardFocus().
void QWaylandSeat::setMouseFocus(QWaylandView *view)
Establece el foco actual del ratón en view.
Véase también mouseFocus().
QWaylandTouch *QWaylandSeat::touch() const
Devuelve el dispositivo táctil correspondiente a este QWaylandSeat.
© 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.