QWaylandSurfaceGrabber Class
Die Klasse „QWaylandSurfaceGrabber“ ermöglicht es, den Inhalt eines „ QWaylandSurface “ auszulesen. Mehr...
| Header: | #include <QWaylandSurfaceGrabber> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| Erbt von: | QObject |
Öffentliche Typen
| enum | Error { InvalidSurface, NoBufferAttached, UnknownBufferType, RendererNotReady } |
Öffentliche Funktionen
| QWaylandSurfaceGrabber(QWaylandSurface *surface, QObject *parent = nullptr) | |
| void | grab() |
| QWaylandSurface * | surface() const |
Ausführliche Beschreibung
Manchmal ist es erforderlich, den Inhalt einer Oberfläche abzurufen, beispielsweise um dem Benutzer einen Screenshot zur Verfügung zu stellen. Die Klasse `QWaylandSurfaceGrabber` bietet eine einfache Methode hierfür, ohne dass man sich darum kümmern muss, welcher Puffertyp hinter der Oberfläche steht – sei es Shared Memory, OpenGL oder etwas anderes.
Dokumentation der Mitgliedstypen
enum QWaylandSurfaceGrabber::Error
Die Enumeration „Error“ beschreibt den Grund für einen fehlgeschlagenen Grab-Vorgang.
| Konstante | Wert | Beschreibung |
|---|---|---|
QWaylandSurfaceGrabber::InvalidSurface | 0 | Die Oberfläche ist null oder anderweitig ungültig. |
QWaylandSurfaceGrabber::NoBufferAttached | 1 | Der Client hat noch keinen Puffer an die Oberfläche angehängt. |
QWaylandSurfaceGrabber::UnknownBufferType | 2 | Der an die Oberfläche angehängte Puffer ist von unbekanntem Typ. |
QWaylandSurfaceGrabber::RendererNotReady | 3 | Der Compositor-Renderer ist noch nicht bereit, den Inhalt der Oberfläche zu übernehmen. |
Dokumentation der Member-Funktionen
[explicit] QWaylandSurfaceGrabber::QWaylandSurfaceGrabber(QWaylandSurface *surface, QObject *parent = nullptr)
Erstellen Sie ein `QWaylandSurfaceGrabber`-Objekt mit dem angegebenen ` surface ` und parent
void QWaylandSurfaceGrabber::grab()
Rufen Sie den Inhalt der Oberflächenmenge dieses Objekts ab. Da dies möglicherweise nicht sofort möglich ist, sollten die Signale „success“ und „failed“ verwendet werden, um benachrichtigt zu werden, sobald der Abruf abgeschlossen ist.
QWaylandSurface *QWaylandSurfaceGrabber::surface() const
Gibt die für dieses Objekt festgelegte Oberfläche 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.
