WaylandSeat QML Type

Ermöglicht den Zugriff auf Tastatur-, Maus- und Toucheingaben. Mehr...

Import Statement: import QtWayland.Compositor
In C++: QWaylandSeat

Signale

Methoden

Detaillierte Beschreibung

Der Typ WaylandSeat ermöglicht den Zugriff auf verschiedene Arten von Benutzereingaben und verwaltet einen Tastaturfokus und einen Mauszeiger. Er entspricht der wl_seat-Schnittstelle im Wayland-Protokoll.

Signal Dokumentation

void cursorSurfaceRequest(QWaylandSurface surface, int hotspotX, int hotspotY)

Dieses Signal wird ausgegeben, wenn der Client eine bestimmte surface als Mauszeiger angefordert hat. Zum Beispiel, wenn der Benutzer über einer bestimmten Oberfläche schwebt und Sie möchten, dass sich der Mauszeiger in einen Größenänderungspfeil verwandelt.

Sowohl hotspotX als auch hotspotY sind Offsets von der linken oberen Ecke einer Zeigerfläche, wo ein Klick stattfinden soll. Wenn die angeforderte Cursorfläche beispielsweise ein Pfeil ist, geben die Parameter an, wo sich die Spitze des Pfeils auf dieser Fläche befindet.

Hinweis: Der entsprechende Handler ist onCursorSurfaceRequest.


void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus)

Dieses Signal wird ausgegeben, wenn setKeyboardFocus() aufgerufen wird oder wenn ein WaylandQuickItem den Fokus hat und der Benutzer beginnt, Tasten zu drücken.

newFocus hat die Oberfläche, die den Tastaturfokus erhalten hat; oder nullptr, wenn keine Oberfläche den Fokus hat. oldFocus hat die Oberfläche, die den Tastaturfokus verloren hat; oder nullptr, wenn keine Oberfläche den Fokus hatte.

Hinweis: Der entsprechende Handler ist onKeyboardFocusChanged.


Dokumentation der Methode

void sendKeyEvent(int qtKey, bool pressed)

Sendet ein Tastendruck- (wenn pressed gleich true ist) oder Loslass-Ereignis (wenn pressed gleich false ist) einer Taste qtKey an das Tastaturgerät.


void sendTouchCancelEvent(WaylandClient client)

Sendet ein Abbruchereignis an das Touch-Gerät einer client.


void sendTouchFrameEvent(WaylandClient client)

Sendet ein Rahmenereignis an das Touch-Gerät eines client, um das Ende einer Reihe von Aufwärts-, Abwärts- und Bewegungsereignissen anzuzeigen.


void sendTouchPointMoved(WaylandSurface surface, int id, point position)

Sendet ein Berührungsbewegungsereignis für den Berührungspunkt id auf surface mit der Position position.

Hinweis: Sie müssen ein Berührungsrahmenereignis senden, wenn Sie mit dem Senden von Berührungsereignissen fertig sind.

Warnung: Diese API sollte nicht in Kombination mit der Weiterleitung von Berührungsereignissen mit WaylandQuickItem::touchEventsEnabled verwendet werden, da dies zu widersprüchlichen Berührungs-IDs führen kann.

Gibt die Serie für das Berührungsbewegungsereignis zurück.


uint sendTouchPointPressed(WaylandSurface surface, int id, point position)

Sendet ein Ereignis "Berührung gedrückt" für den Berührungspunkt id auf surface mit der Position position.

Hinweis: Sie müssen ein Berührungsrahmenereignis senden, wenn Sie mit dem Senden von Berührungsereignissen fertig sind.

Warnung: Diese API sollte nicht in Kombination mit der Weiterleitung von Berührungsereignissen mit WaylandQuickItem::touchEventsEnabled verwendet werden, da dies zu widersprüchlichen Berührungs-IDs führen kann.

Gibt die Serie für das Touchdown-Ereignis zurück.


void sendTouchPointReleased(WaylandSurface surface, int id, point position)

Sendet ein Ereignis "Berührung freigegeben" für den Berührungspunkt id auf surface mit der Position position.

Hinweis: Sie müssen ein Berührungsrahmenereignis senden, wenn Sie mit dem Senden von Berührungsereignissen fertig sind.

Warnung: Diese API sollte nicht in Kombination mit der Weiterleitung von Berührungsereignissen mit WaylandQuickItem::touchEventsEnabled verwendet werden, da dies zu widersprüchlichen Berührungs-IDs führen kann.

Gibt die Serie für das Berührungsereignis zurück.


[since 6.7] void sendUnicodeKeyPressEvent(uint unicode)

Sendet ein Tastendruckereignis eines UCS4 unicode über ein Texteingabeprotokoll.

Hinweis: Diese Funktion funktioniert nicht ordnungsgemäß, wenn der Client das Texteingabeprotokoll, das der Compositor unterstützt, nicht unterstützt.

Diese Methode wurde in Qt 6.7 eingeführt.


[since 6.7] void sendUnicodeKeyReleaseEvent(uint unicode)

Sendet ein Tastenfreigabeereignis eines UCS4 unicode über ein Texteingabeprotokoll.

Hinweis: Diese Funktion funktioniert nicht ordnungsgemäß, wenn der Client das Texteingabeprotokoll, das der Compositor unterstützt, nicht unterstützt.

Diese Methode wurde in Qt 6.7 eingeführt.


© 2025 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.