QWaylandSurfaceGrabber Class

Die Klasse QWaylandSurfaceGrabber erlaubt es, den Inhalt einer QWaylandSurface zu lesen. Mehr...

Kopfzeile: #include <QWaylandSurfaceGrabber>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
Vererbt: QObject

Öffentliche Typen

enum Error { InvalidSurface, NoBufferAttached, UnknownBufferType, RendererNotReady }

Öffentliche Funktionen

QWaylandSurfaceGrabber(QWaylandSurface *surface, QObject *parent = nullptr)
void grab()
QWaylandSurface *surface() const

Detaillierte Beschreibung

Manchmal ist es notwendig, den Inhalt einer Oberfläche abzurufen, zum Beispiel um dem Benutzer einen Screenshot zur Verfügung zu stellen. Die Klasse QWaylandSurfaceGrabber bietet eine einfache Methode, um dies zu tun, ohne sich darum kümmern zu müssen, welche Art von Puffer hinter der Oberfläche steht, sei es Shared Memory, OpenGL oder etwas anderes.

Dokumentation der Mitgliedstypen

enum QWaylandSurfaceGrabber::Error

Die Aufzählung Error beschreibt den Grund für ein Fehlschlagen des Greifvorgangs.

KonstanteWertBeschreibung
QWaylandSurfaceGrabber::InvalidSurface0Die Oberfläche ist null oder anderweitig ungültig.
QWaylandSurfaceGrabber::NoBufferAttached1Der Client hat noch keinen Puffer an die Oberfläche angehängt.
QWaylandSurfaceGrabber::UnknownBufferType2Der an die Oberfläche angehängte Puffer ist von einem unbekannten Typ.
QWaylandSurfaceGrabber::RendererNotReady3Der Compositor-Renderer ist nicht bereit, den Oberflächeninhalt zu erfassen.

Dokumentation der Mitgliedsfunktionen

[explicit] QWaylandSurfaceGrabber::QWaylandSurfaceGrabber(QWaylandSurface *surface, QObject *parent = nullptr)

Erzeugt ein QWaylandSurfaceGrabber Objekt mit der angegebenen surface und parent

void QWaylandSurfaceGrabber::grab()

Holt den Inhalt der auf diesem Objekt eingestellten Oberfläche. Es ist möglicherweise nicht möglich, dies sofort zu tun, so dass die Erfolgs- und Misserfolgssignale verwendet werden sollten, um benachrichtigt zu werden, wenn die Erfassung abgeschlossen ist.

QWaylandSurface *QWaylandSurfaceGrabber::surface() const

Gibt die auf dieses Objekt gesetzte Oberfläche 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.