QWaylandQuickItem Class
Die Klasse „QWaylandQuickItem“ stellt ein „ Qt Quick “-Element bereit, das die Oberfläche eines Wayland-Clients darstellt. Mehr...
| Header: | #include <QWaylandQuickItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| In QML: | WaylandQuickItem |
| Erbt von: | QQuickItem |
| Vererbt an: |
Eigenschaften
|
|
Öffentliche Funktionen
| QWaylandQuickItem(QQuickItem *parent = nullptr) | |
| virtual | ~QWaylandQuickItem() override |
| bool | allowDiscardFrontBuffer() const |
| QWaylandCompositor * | compositor() const |
| bool | focusOnClick() const |
| bool | inputEventsEnabled() const |
| bool | inputRegionContains(const QPointF &localPosition) const |
| bool | isBufferLocked() const |
| bool | isPaintEnabled() const |
| QPointF | mapFromSurface(const QPointF &point) const |
| QPointF | mapToSurface(const QPointF &point) const |
| QWaylandSurface::Origin | origin() const |
| QWaylandOutput * | output() const |
| void | setAllowDiscardFrontBuffer(bool discard) |
| void | setBufferLocked(bool locked) |
| void | setFocusOnClick(bool focus) |
| void | setInputEventsEnabled(bool enabled) |
| void | setOutput(QWaylandOutput *output) |
| void | setPrimary() |
| void | setSubsurfaceHandler(QObject *) |
| void | setSurface(QWaylandSurface *surface) |
| void | setTouchEventsEnabled(bool enabled) |
| QObject * | subsurfaceHandler() const |
| QWaylandSurface * | surface() const |
| bool | touchEventsEnabled() const |
| QWaylandView * | view() const |
Neu implementierte öffentliche Funktionen
| virtual QSGTextureProvider * | textureProvider() const override |
Öffentliche Slots
| void | setPaintEnabled(bool paintEnabled) |
| virtual void | takeFocus(QWaylandSeat *device = nullptr) |
Signale
| void | allowDiscardFrontBufferChanged() |
| void | bufferLockedChanged() |
| void | compositorChanged() |
| void | focusOnClickChanged() |
| void | inputEventsEnabledChanged() |
| void | originChanged() |
| void | outputChanged() |
| void | paintEnabledChanged() |
| void | subsurfaceHandlerChanged() |
| void | surfaceChanged() |
| void | surfaceDestroyed() |
| void | touchEventsEnabledChanged() |
Ausführliche Beschreibung
Beim Schreiben eines „ QWaylandCompositor “ in „ Qt Quick “ kann diese Klasse verwendet werden, um die Inhalte eines Clients auf einem Ausgabegerät anzuzeigen und Benutzereingaben an den Client weiterzuleiten.
Dokumentation der Eigenschaften
allowDiscardFrontBuffer : bool
Standardmäßig sperrt das Element den aktuellen Puffer, bis ein neuer Puffer verfügbar ist und „ updatePaintNode()“ aufgerufen wird. Setzen Sie diese Eigenschaft auf „true“, damit Qt den Puffer sofort freigibt, sobald die Throttling-Ansicht ihn nicht mehr verwendet. Dies ist nützlich für Elemente mit langsamen Aktualisierungsintervallen.
Zugriffsfunktionen:
| bool | allowDiscardFrontBuffer() const |
| void | setAllowDiscardFrontBuffer(bool discard) |
Notifier-Signal:
| void | allowDiscardFrontBufferChanged() |
bufferLocked : bool
Diese Eigenschaft gibt an, ob der Puffer des Elements derzeit gesperrt ist. Solange der Puffer gesperrt ist, wird er nicht freigegeben und an den Client zurückgegeben.
Der Standardwert ist „false“.
Zugriffsfunktionen:
| bool | isBufferLocked() const |
| void | setBufferLocked(bool locked) |
Notifier-Signal:
| void | bufferLockedChanged() |
[read-only] compositor : QWaylandCompositor*
Diese Eigenschaft enthält den Compositor für die von diesem „ QWaylandQuickItem “ gerenderte Oberfläche.
Zugriffsfunktionen:
| QWaylandCompositor * | compositor() const |
Notifier-Signal:
| void | compositorChanged() |
focusOnClick : bool
Diese Eigenschaft legt fest, ob das „ QWaylandQuickItem “ den Fokus erhalten soll, wenn es angeklickt oder berührt wird.
Die Standardeinstellung ist „ true “.
Zugriffsfunktionen:
| bool | focusOnClick() const |
| void | setFocusOnClick(bool focus) |
Notifier-Signal:
| void | focusOnClickChanged() |
inputEventsEnabled : bool
Diese Eigenschaft gibt an, ob Eingabeereignisse für dieses Element aktiviert sind.
Wenn „ true “ ist, verarbeitet und behandelt das Element Eingabeereignisse wie Tastatur- und Mausereignisse; wenn „ false “ ist, werden Eingabeereignisse ignoriert.
Zugriffsfunktionen:
| bool | inputEventsEnabled() const |
| void | setInputEventsEnabled(bool enabled) |
Notifier-Signal:
| void | inputEventsEnabledChanged() |
[read-only] origin : QWaylandSurface::Origin
Diese Eigenschaft gibt den Ursprung des aktuellen Oberflächenpuffers an, d. h., welche Ecke des Puffers der Koordinate (0, 0) entspricht.
Zugriffsfunktionen:
| QWaylandSurface::Origin | origin() const |
Benachrichtigungssignal:
| void | originChanged() |
Siehe auch „ QWaylandSurface::origin “.
output : QWaylandOutput*
Diese Eigenschaft enthält die Ausgabekomponente, auf der dieses Element angezeigt wird.
Zugriffsfunktionen:
| QWaylandOutput * | output() const |
| void | setOutput(QWaylandOutput *output) |
Benachrichtigungssignal:
| void | outputChanged() |
paintEnabled : bool
Wenn Sie diese Eigenschaft auf „ false “ setzen, wird die Darstellung des Elements unterbunden. Im Gegensatz zum Ausblenden des Elements durch Setzen von „ visible “ auf „ false “ wird dadurch nicht verhindert, dass Maus- oder Tastatureingaben das Element erreichen.
Zugriffsfunktionen:
| bool | isPaintEnabled() const |
| void | setPaintEnabled(bool paintEnabled) |
Notifier-Signal:
| void | paintEnabledChanged() |
subsurfaceHandler : QObject*
Diese Eigenschaft bietet die Möglichkeit, das Standardverhalten der Unterfläche zu überschreiben.
Standardmäßig erstellt Qt ein neues „ QWaylandQuickItem “ als untergeordnetes Element dieses Elements und behält dabei die korrekte Position bei.
Um das Standardverhalten zu überschreiben, weisen Sie dieser Eigenschaft ein Handler-Objekt zu. Der Handler muss eine Methode „ handleSubsurfaceAdded(QWaylandSurface*) “ implementieren.
Der Standardwert dieser Eigenschaft ist „ nullptr “.
Zugriffsfunktionen:
| QObject * | subsurfaceHandler() const |
| void | setSubsurfaceHandler(QObject *) |
Notifier-Signal:
| void | subsurfaceHandlerChanged() |
surface : QWaylandSurface*
Diese Eigenschaft enthält die von diesem „ QWaylandQuickItem “ gerenderte Oberfläche.
Zugriffsfunktionen:
| QWaylandSurface * | surface() const |
| void | setSurface(QWaylandSurface *surface) |
Notifier-Signal:
| void | surfaceChanged() |
touchEventsEnabled : bool
Diese Eigenschaft nimmt den Wert „ true “ an, wenn Berührungsereignisse an die Client-Oberfläche weitergeleitet werden, andernfalls „ false “.
Zugriffsfunktionen:
| bool | touchEventsEnabled() const |
| void | setTouchEventsEnabled(bool enabled) |
Notifier-Signal:
| void | touchEventsEnabledChanged() |
Dokumentation der Mitgliedsfunktionen
QWaylandQuickItem::QWaylandQuickItem(QQuickItem *parent = nullptr)
Erstellt ein `QWaylandQuickItem` mit dem angegebenen ` parent`.
[override virtual noexcept] QWaylandQuickItem::~QWaylandQuickItem()
Zerstöre die „ QWaylandQuickItem “.
bool QWaylandQuickItem::inputRegionContains(const QPointF &localPosition) const
Gibt ` true ` zurück, wenn der Eingabebereich der Oberfläche dieses Elements die durch ` localPosition` angegebene Position enthält.
[invokable] QPointF QWaylandQuickItem::mapFromSurface(const QPointF &point) const
Ordnet die angegebene „ point “ im Koordinatensystem der Wayland-Oberfläche dem entsprechenden Punkt im Koordinatensystem dieses Elements zu und gibt die zugeordnete Koordinate zurück.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QPointF QWaylandQuickItem::mapToSurface(const QPointF &point) const
Ordnet die angegebene „ point “ im Koordinatensystem dieses Elements dem entsprechenden Punkt im Koordinatensystem der Wayland-Oberfläche zu und gibt die zugeordnete Koordinate zurück.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QWaylandQuickItem::setPrimary()
Macht die Ansicht „ QWaylandQuickItem “ zur primären Ansicht für die Oberfläche.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch QWaylandSurface::primaryView.
[signal] void QWaylandQuickItem::surfaceDestroyed()
Dieses Signal wird ausgelöst, wenn der Client das mit dem ` QWaylandQuickItem` verknüpfte ` wl_surface ` gelöscht hat. Der Handler für dieses Signal soll entweder das ` QWaylandQuickItem ` sofort löschen oder eine Schließanimation starten und anschließend das `Item` löschen.
Wird eine Animation gestartet, sollte ` bufferLocked ` so gesetzt werden, dass das Item seinen Inhalt beibehält, bis die Animation beendet ist
Siehe auch QWaylandQuickItem::bufferLocked.
[virtual slot] void QWaylandQuickItem::takeFocus(QWaylandSeat *device = nullptr)
Durch den Aufruf dieser Funktion erhält das Element den Fokus des Eingabe device s.
[override virtual] QSGTextureProvider *QWaylandQuickItem::textureProvider() const
Implementiert neu: QQuickItem::textureProvider() const.
Gibt den Textur-Provider dieses ` QWaylandQuickItem` zurück.
QWaylandView *QWaylandQuickItem::view() const
Gibt die von diesem „ QWaylandQuickItem “ gerenderte Ansicht zurück.
© 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.
