En esta página

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

  • drag : QWaylandDrag* const
  • keymap : QWaylandKeymap* const

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 ».

ConstanteValorDescripción
QWaylandSeat::Pointer0x01El « QWaylandSeat » admite la entrada mediante puntero.
QWaylandSeat::Keyboard0x02El « QWaylandSeat » admite la entrada mediante teclado.
QWaylandSeat::Touch0x04El « QWaylandSeat » admite la entrada táctil.
QWaylandSeat::DefaultCapabilitiesPointer | Keyboard | TouchEl ` 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.