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.

Ejecución del ejemplo
Puede ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
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.
© 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.