QWaylandQuickItem Class
Die Klasse QWaylandQuickItem stellt ein Qt Quick Element zur Verfügung, das ein QWaylandView darstellt. Mehr...
| Kopfzeile: | #include <QWaylandQuickItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| In QML: | WaylandQuickItem |
| Vererbt: | QQuickItem |
| Vererbt von: |
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 |
Reimplementierte ö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() |
Detaillierte Beschreibung
Beim Schreiben eines QWaylandCompositor in Qt Quick kann diese Klasse verwendet werden, um den Inhalt eines Clients auf einem Ausgabegerät anzuzeigen und Benutzereingaben an den Client weiterzuleiten.
Eigenschaft Dokumentation
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, um Qt zu erlauben, den Puffer sofort freizugeben, wenn die drosselnde Ansicht ihn nicht mehr verwendet. Dies ist nützlich für Elemente, die langsame Aktualisierungsintervalle haben.
Zugriffsfunktionen:
| bool | allowDiscardFrontBuffer() const |
| void | setAllowDiscardFrontBuffer(bool discard) |
Notifier Signal:
| void | allowDiscardFrontBufferChanged() |
bufferLocked : bool
Diese Eigenschaft gibt an, ob der Puffer des Objekts derzeit gesperrt ist. Solange der Puffer gesperrt ist, wird er nicht freigegeben und an den Kunden zurückgegeben.
Der Standardwert ist false.
Zugriffsfunktionen:
| bool | isBufferLocked() const |
| void | setBufferLocked(bool locked) |
Benachrichtigungssignal:
| void | bufferLockedChanged() |
[read-only] compositor : QWaylandCompositor* const
Diese Eigenschaft enthält den Compositor für die Oberfläche, die von dieser QWaylandQuickItem gerendert wird.
Zugriffsfunktionen:
| QWaylandCompositor * | compositor() const |
Benachrichtigungssignal:
| void | compositorChanged() |
focusOnClick : bool
Diese Eigenschaft gibt an, ob der QWaylandQuickItem den Fokus erhalten soll, wenn er angeklickt oder berührt wird.
Die Voreinstellung ist true.
Zugriffsfunktionen:
| bool | focusOnClick() const |
| void | setFocusOnClick(bool focus) |
Benachrichtigungssignal:
| void | focusOnClickChanged() |
[read-only] origin : const QWaylandSurface::Origin
Diese Eigenschaft hält den Ursprung der QWaylandQuickItem fest.
Zugriffsfunktionen:
| QWaylandSurface::Origin | origin() const |
Benachrichtigungssignal:
| void | originChanged() |
output : QWaylandOutput*
Diese Eigenschaft enthält den Ausgang, auf dem dieses Element angezeigt wird.
Zugriffsfunktionen:
| QWaylandOutput * | output() const |
| void | setOutput(QWaylandOutput *output) |
Melder-Signal:
| void | outputChanged() |
paintEnabled : bool
Hält true, wenn das Element ausgeblendet ist, obwohl die Textur weiterhin aktualisiert wird. Im Gegensatz zum Ausblenden des Elements durch Setzen von visible auf false verhindert das Setzen dieser Eigenschaft auf false nicht, dass Maus- oder Tastatureingaben das Element erreichen.
Zugriffsfunktionen:
| bool | isPaintEnabled() const |
| void | setPaintEnabled(bool paintEnabled) |
Benachrichtigungssignal:
| void | paintEnabledChanged() |
surface : QWaylandSurface*
Diese Eigenschaft enthält die von diesem QWaylandQuickItem gerenderte Oberfläche.
Zugriffsfunktionen:
| QWaylandSurface * | surface() const |
| void | setSurface(QWaylandSurface *surface) |
Benachrichtigungssignal:
| void | surfaceChanged() |
touchEventsEnabled : bool
Diese Eigenschaft enthält true, wenn Berührungsereignisse an die Client-Oberfläche weitergeleitet werden, andernfalls false.
Zugriffsfunktionen:
| bool | touchEventsEnabled() const |
| void | setTouchEventsEnabled(bool enabled) |
Benachrichtigungssignal:
| void | touchEventsEnabledChanged() |
Member Function Dokumentation
QWaylandQuickItem::QWaylandQuickItem(QQuickItem *parent = nullptr)
Konstruiert ein QWaylandQuickItem mit der angegebenen parent.
[override virtual noexcept] QWaylandQuickItem::~QWaylandQuickItem()
Zerstören Sie 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
Überträgt den angegebenen point im Koordinatensystem der Wayland-Oberfläche auf den entsprechenden Punkt im Koordinatensystem dieses Objekts und gibt die übertragene Koordinate zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QPointF QWaylandQuickItem::mapToSurface(const QPointF &point) const
Überträgt den angegebenen point im Koordinatensystem dieses Objekts auf den entsprechenden Punkt im Koordinatensystem der Wayland-Oberfläche und gibt die übertragene Koordinate zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QWaylandQuickItem::setPrimary()
Macht die Ansicht dieser QWaylandQuickItem zur primären Ansicht für die Oberfläche.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch QWaylandSurface::primaryView.
[signal] void QWaylandQuickItem::surfaceDestroyed()
Dieses Signal wird ausgegeben, wenn der Client das mit QWaylandQuickItem verknüpfte wl_surface zerstört hat. Vom Handler für dieses Signal wird erwartet, dass er entweder das QWaylandQuickItem sofort zerstört oder eine Schließanimation startet und dann das Element zerstört.
Wenn eine Animation gestartet wird, sollte bufferLocked gesetzt werden, um sicherzustellen, dass das Element seinen Inhalt behält, bis die Animation beendet ist.
Siehe auch QWaylandQuickItem::bufferLocked.
[virtual slot] void QWaylandQuickItem::takeFocus(QWaylandSeat *device = nullptr)
Der Aufruf dieser Funktion bewirkt, dass das Element den Fokus der Eingabe device erhält.
[override virtual] QSGTextureProvider *QWaylandQuickItem::textureProvider() const
Reimplements: QQuickItem::textureProvider() const.
Gibt den Texturanbieter dieser QWaylandQuickItem zurück.
QWaylandView *QWaylandQuickItem::view() const
Gibt die von dieser QWaylandQuickItem gerenderte Ansicht zurück.
© 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.
