WaylandSeat QML Type (Uncreatable)
Bietet Zugriff auf Tastatur-, Maus- und Touch-Eingaben. Mehr...
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandSeat |
Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.
Signale
- void cursorSurfaceRequest(QWaylandSurface surface, int hotspotX, int hotspotY)
- void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus)
Methoden
- 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)
Ausführliche Beschreibung
Der Typ „WaylandSeat“ ermöglicht den Zugriff auf verschiedene Arten von Benutzereingaben und verwaltet den Tastaturfokus sowie den Mauszeiger. Er entspricht der Schnittstelle „wl_seat“ im Wayland-Protokoll.
Signal-Dokumentation
void cursorSurfaceRequest(QWaylandSurface surface, int hotspotX, int hotspotY)
Dieses Signal wird ausgelöst, wenn der Client angefordert hat, dass ein bestimmtes „ surface “ als Mauszeiger verwendet wird. Beispielsweise wenn der Benutzer mit der Maus über eine bestimmte Fläche fährt und Sie möchten, dass sich der Mauszeiger in einen Pfeil zum Ändern der Größe verwandelt.
Sowohl ` hotspotX ` als auch ` hotspotY ` sind Offsets von der oberen linken Ecke einer Zeigerfläche, an der ein Klick erfolgen soll. Ist die angeforderte Cursorfläche beispielsweise ein Pfeil, geben die Parameter an, wo sich die Pfeilspitze auf dieser Fläche befindet.
Hinweis: Der entsprechende Handler ist onCursorSurfaceRequest.
void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus)
Dieses Signal wird ausgelöst, wenn setKeyboardFocus() aufgerufen wird oder wenn eine „ WaylandQuickItem “ den Fokus hat und der Benutzer beginnt, Tasten zu drücken.
newFocus enthält die Oberfläche, die den Tastaturfokus erhalten hat; oder nullptr, wenn keine Oberfläche den Fokus hat. oldFocus enthält die Oberfläche, die den Tastaturfokus verloren hat; oder nullptr, wenn keine Oberfläche den Fokus hatte.
Hinweis: Der entsprechende Handler ist onKeyboardFocusChanged.
Methodendokumentation
void sendKeyEvent(int qtKey, bool pressed)
Sendet ein Tastenanschlag-Ereignis (wenn „ pressed “ auf „ true “ gesetzt ist) oder ein Tastenloslass-Ereignis (wenn „ pressed “ auf „ false “ gesetzt ist) für die Taste „ qtKey “ an das Tastaturgerät.
void sendTouchCancelEvent(WaylandClient client)
Sendet ein „Cancel“-Ereignis an das Touch-Gerät eines „ client “.
void sendTouchFrameEvent(WaylandClient client)
Sendet ein Frame-Ereignis an das Touch-Gerät eines „ client “, um das Ende einer Abfolge von Berührungs-, Abwärts- und Bewegungsereignissen anzuzeigen.
void sendTouchPointMoved(WaylandSurface surface, int id, point position)
Sendet ein „Touch Moved“-Ereignis für den Berührungspunkt id auf surface mit der Position position.
Hinweis: Sie müssen ein Touch-Frame-Ereignis senden, wenn Sie mit dem Senden von Touch-Ereignissen fertig sind.
Warnung: Diese API sollte nicht in Kombination mit der Weiterleitung von Touch-Ereignissen über WaylandQuickItem::touchEventsEnabled verwendet werden, da dies zu Konflikten bei den Touch-IDs führen kann.
Gibt die Seriennummer des Touch-Bewegungsereignisses zurück.
uint sendTouchPointPressed(WaylandSurface surface, int id, point position)
Sendet ein „Touch-gedrückt“-Ereignis für den Berührungspunkt id auf surface mit der Position position.
Hinweis: Sie müssen ein Touch-Frame-Ereignis senden, wenn Sie mit dem Senden von Touch-Ereignissen fertig sind.
Warnung: Diese API sollte nicht in Kombination mit der Weiterleitung von Berührungsereignissen über WaylandQuickItem::touchEventsEnabled verwendet werden, da dies zu Konflikten bei den Berührungs-IDs führen kann.
Gibt die Seriennummer für das Touch-Down-Ereignis zurück.
void sendTouchPointReleased(WaylandSurface surface, int id, point position)
Sendet ein „Touch-Released“-Ereignis für den Berührungspunkt id auf surface mit der Position position.
Hinweis: Sie müssen ein „Touch-Frame“-Ereignis senden, wenn Sie das Senden von Touch-Ereignissen abgeschlossen haben.
Warnung: Diese API sollte nicht in Kombination mit der Weiterleitung von Touch-Ereignissen über WaylandQuickItem::touchEventsEnabled verwendet werden, da dies zu Konflikten bei den Touch-IDs führen kann.
Gibt die Seriennummer für das „Touch-up“-Ereignis zurück.
[since 6.7] void sendUnicodeKeyPressEvent(uint unicode)
Sendet ein Tastendruck-Ereignis eines UCS4- unicode s über ein Texteingabeprotokoll.
Hinweis: Diese Funktion funktioniert nicht ordnungsgemäß, wenn der Client das vom Compositor unterstützte Texteingabeprotokoll nicht unterstützt.
Diese Methode wurde in Qt 6.7 eingeführt.
[since 6.7] void sendUnicodeKeyReleaseEvent(uint unicode)
Sendet ein Tastenloslass-Ereignis eines UCS4- unicode s über ein Texteingabeprotokoll.
Hinweis: Diese Funktion funktioniert nicht ordnungsgemäß, wenn der Client das vom Compositor unterstützte Texteingabeprotokoll nicht unterstützt.
Diese Methode wurde in Qt 6.7 eingeführt.
© 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.
