WaylandSeat QML Type
Permet d'accéder au clavier, à la souris et aux entrées tactiles. Plus d'informations...
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandSeat |
Signaux
- void cursorSurfaceRequest(QWaylandSurface surface, int hotspotX, int hotspotY)
- void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus)
Méthodes
- 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)
Description détaillée
Le type WaylandSeat permet d'accéder à différents types d'entrées utilisateur et de maintenir le focus du clavier et le pointeur de la souris. Il correspond à l'interface wl_seat du protocole Wayland.
Documentation sur les signaux
void cursorSurfaceRequest(QWaylandSurface surface, int hotspotX, int hotspotY)
Ce signal est émis lorsque le client a demandé qu'une adresse surface spécifique devienne le curseur de la souris. Par exemple, lorsque l'utilisateur survole une surface particulière et que vous souhaitez que le curseur se transforme en flèche de redimensionnement.
hotspotX et hotspotY sont des décalages par rapport à la partie supérieure gauche de la surface du pointeur, là où un clic doit se produire. Par exemple, si la surface du curseur demandée est une flèche, les paramètres indiquent où se trouve la pointe de la flèche sur cette surface.
Remarque : le gestionnaire correspondant est onCursorSurfaceRequest.
void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus)
Ce signal est émis lorsque setKeyboardFocus() est appelé ou lorsqu'un site WaylandQuickItem a le focus et que l'utilisateur commence à appuyer sur les touches.
newFocus a la surface qui a reçu le focus clavier ; ou nullptr si aucune surface n'a le focus. oldFocus a la surface qui a perdu le focus clavier ; ou nullptr si aucune surface n'avait le focus.
Remarque : le gestionnaire correspondant est onKeyboardFocusChanged.
Documentation de la méthode
void sendKeyEvent(int qtKey, bool pressed)
Envoie un événement de pression (si pressed est true) ou de relâchement (si pressed est false) d'une touche qtKey au clavier.
void sendTouchCancelEvent(WaylandClient client)
Envoi d'un événement d'annulation à l'appareil tactile d'un client.
void sendTouchFrameEvent(WaylandClient client)
Envoie un événement de trame au dispositif tactile d'un site client pour indiquer la fin d'une série d'événements de toucher vers le haut, vers le bas et de mouvement.
void sendTouchPointMoved(WaylandSurface surface, int id, point position)
Envoie un événement tactile déplacé pour le point de contact id sur surface avec la position position.
Remarque : vous devez envoyer un événement de cadre tactile lorsque vous avez fini d'envoyer des événements tactiles.
Attention : Cette API ne doit pas être utilisée en combinaison avec la transmission d'événements tactiles à l'aide de WaylandQuickItem::touchEventsEnabled, car cela pourrait entraîner des conflits d'identifiants tactiles.
Renvoie le numéro de série de l'événement de mouvement tactile.
uint sendTouchPointPressed(WaylandSurface surface, int id, point position)
Envoie un événement de contact appuyé pour le point de contact id sur surface avec la position position.
Remarque : vous devez envoyer un événement de cadre tactile lorsque vous avez fini d'envoyer des événements tactiles.
Attention : Cette API ne doit pas être utilisée en combinaison avec la transmission d'événements tactiles à l'aide de WaylandQuickItem::touchEventsEnabled, car cela pourrait entraîner des conflits d'identifiants tactiles.
Renvoie le numéro de série de l'événement "touch down".
void sendTouchPointReleased(WaylandSurface surface, int id, point position)
Envoie un événement tactile validé pour le point de contact id sur surface avec la position position.
Remarque : vous devez envoyer un événement de cadre tactile lorsque vous avez fini d'envoyer des événements tactiles.
Attention : Cette API ne doit pas être utilisée en combinaison avec la transmission d'événements tactiles à l'aide de WaylandQuickItem::touchEventsEnabled, car cela pourrait entraîner des conflits d'identifiants tactiles.
Renvoie le numéro de série de l'événement "touch up".
[since 6.7] void sendUnicodeKeyPressEvent(uint unicode)
Envoie un événement d'appui sur une touche UCS4 unicode par le biais d'un protocole d'entrée de texte.
Remarque : cette fonction ne fonctionnera pas correctement si le client ne prend pas en charge le protocole d'entrée de texte pris en charge par le compositeur.
Cette méthode a été introduite dans Qt 6.7.
[since 6.7] void sendUnicodeKeyReleaseEvent(uint unicode)
Envoi d'un événement de libération de clé d'un UCS4 unicode par le biais d'un protocole d'entrée de texte.
Remarque : cette fonction ne fonctionnera pas correctement si le client ne prend pas en charge le protocole d'entrée de texte pris en charge par le compositeur.
Cette méthode a été introduite dans 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.