En esta página

QWaylandSurfaceGrabber Class

La clase `QWaylandSurfaceGrabber` permite leer el contenido de una ` QWaylandSurface`. Más información...

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

Tipos públicos

enum Error { InvalidSurface, NoBufferAttached, UnknownBufferType, RendererNotReady }

Funciones públicas

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

Descripción detallada

A veces es necesario obtener el contenido de una superficie, por ejemplo, para proporcionar una captura de pantalla al usuario. La clase QWaylandSurfaceGrabber ofrece un método sencillo para hacerlo, sin tener que preocuparse por el tipo de búfer que respalda la superficie, ya sea memoria compartida, OpenGL u otro.

Documentación sobre los tipos de miembros

enum QWaylandSurfaceGrabber::Error

La enumeración «Error» describe el motivo por el que ha fallado una captura.

ConstanteValorDescripción
QWaylandSurfaceGrabber::InvalidSurface0La superficie es nula o no es válida por cualquier otro motivo.
QWaylandSurfaceGrabber::NoBufferAttached1El cliente aún no ha asociado un búfer a la superficie.
QWaylandSurfaceGrabber::UnknownBufferType2El búfer adjunto a la superficie es de un tipo desconocido.
QWaylandSurfaceGrabber::RendererNotReady3El renderizador del compositor no está listo para capturar el contenido de la superficie.

Documentación de las funciones de miembro

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

Crea un objeto `QWaylandSurfaceGrabber` con el ` surface ` indicado y parent

void QWaylandSurfaceGrabber::grab()

Obtén el contenido del conjunto de superficies de este objeto. Es posible que no se pueda hacer de forma inmediata, por lo que debes utilizar las señales de éxito y de error para recibir una notificación cuando se haya completado la obtención.

QWaylandSurface *QWaylandSurfaceGrabber::surface() const

Devuelve el conjunto de superficies de este objeto.

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