En esta página

Ejemplo de captura de pantalla

Captura de una pantalla o ventana.

La captura de pantalla muestra cómo capturar una pantalla o una ventana utilizando QScreenCapture y QWindowCapture. El ejemplo muestra una lista de pantallas y ventanas y ofrece una vista previa en tiempo real del elemento seleccionado mediante QMediaCaptureSession y QVideoWidget. La captura se puede iniciar y detener con button.

Interfaz de usuario que muestra una lista de pantallas junto con la captura de pantalla correspondiente

Ejecución del ejemplo

Puede ejecutar el ejemplo desde:

Estructura de la aplicación

El ejemplo consta de tres clases personalizadas. La interfaz de usuario y toda la funcionalidad de captura de pantalla se implementan en la clase `ScreenCapturePreview`. Las clases `ScreenListModel` y `WindowListModel` solo sirven como modelos detrás de los dos widgets ` QListView `. La función principal crea un objeto `ScreenCapturePreview`, que a su vez crea instancias de ` QScreenCapture ` y ` QWindowCapture`, así como de ` QMediaCaptureSession ` y ` QVideoWidget`, además de todos los widgets de la interfaz de usuario.

Los modelos de pantalla y ventana se rellenan con los valores devueltos por QGuiApplication::screens() y QWindowCapture::capturableWindows(), respectivamente.

Cuando se selecciona un elemento de la lista, este se conecta al objeto ` QScreenCapture ` mediante ` setScreen()`, o al objeto ` QWindowCapture ` mediante ` setWindow()`. El objeto de captura se conecta al objeto ` QMediaCaptureSession ` mediante ` setScreenCapture()` y ` setWindowCapture()`, respectivamente. La sesión de captura, a su vez, se conecta al objeto QVideoWidget mediante setVideoOutput(). De este modo, la salida de la captura se previsualiza en el widget de vídeo situado en la parte derecha de la interfaz de usuario.

El botón de inicio/parada llama a QScreenCapture::start() y QScreenCapture::stop(), o bien a QWindowCapture::start() y QWindowCapture::stop().

Aparece un QMessageBox si se emite la señal errorOccurred.

Proyecto de ejemplo en code.qt.io

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