QWindowCapture Class
Esta clase se utiliza para capturar una ventana. Más...
| Cabecera: | #include <QWindowCapture> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia)target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| Desde: | Qt 6.6 |
| En QML: | WindowCapture |
| Hereda: | QObject |
Tipos Públicos
| enum | Error { NoError, InternalError, CapturingNotSupported, CaptureFailed, NotFound } |
Propiedades
- active : bool
- error : Error
- errorString : QString
- window : QCapturableWindow
Funciones públicas
| QWindowCapture(QObject *parent = nullptr) | |
| virtual | ~QWindowCapture() override |
| QWindowCapture::Error | error() const |
| QString | errorString() const |
| bool | isActive() const |
| void | setWindow(QCapturableWindow window) |
| QCapturableWindow | window() const |
Ranuras públicas
Señales
| void | activeChanged(bool) |
| void | errorChanged() |
| void | errorOccurred(QWindowCapture::Error error, const QString &errorString) |
| void | windowChanged(QCapturableWindow window) |
Miembros públicos estáticos
| QList<QCapturableWindow> | capturableWindows() |
Descripción Detallada
La clase captura una ventana. Es manejada por la clase QMediaCaptureSession donde la ventana capturada puede ser mostrada en un objeto de previsualización de video o grabada en un archivo.
Limitaciones de la captura de ventanas
Las siguientes limitaciones se aplican al uso de QWindowCapture:
- QWindowCapture sólo es compatible con el backend FFmpeg.
Las siguientes limitaciones se aplican cuando se utiliza QWindowCapture en sistemas X11:
- En sistemas Linux X11, cuando una ventana se mueve parcialmente fuera del área visible de la pantalla, sólo se captura la región visible. Como resultado, los fotogramas de vídeo emitidos pueden tener un tamaño inferior a la geometría de la ventana.
- Las ventanas que están fuera del área visible de la pantalla no pueden ser capturadas, y en ese caso se emite una señal de error.
- El comportamiento de las ventanas minimizadas o situadas en un espacio de trabajo virtual invisible depende del gestor de ventanas. Por ejemplo, tales ventanas pueden ser capturadas en GNOME, mientras que en WindowMaker o Xfwm tal captura no está permitida, y la instancia de captura de ventanas emite un error.
Véase también QMediaCaptureSession y QCapturableWindow.
Documentación de tipos de miembros
enum QWindowCapture::Error
Enumera los códigos de error que pueden ser señalados por la clase QWindowCapture. errorString() proporciona información detallada sobre la causa del error.
| Constante | Valor | Descripción |
|---|---|---|
QWindowCapture::NoError | 0 | No error |
QWindowCapture::InternalError | 1 | Error interno del controlador de captura de ventanas |
QWindowCapture::CapturingNotSupported | 2 | No se admite la captura de ventanas |
QWindowCapture::CaptureFailed | 4 | Error de captura de ventana |
QWindowCapture::NotFound | 5 | Ventana seleccionada no encontrada |
Documentación de propiedades
active : bool
Esta propiedad indica si la captura está actualmente activa.
Funciones de acceso:
| bool | isActive() const |
| void | setActive(bool active) |
Señal del notificador:
| void | activeChanged(bool) |
Véase también start() y stop().
[read-only] error : Error
Esta propiedad contiene el código del último error.
Funciones de acceso:
| QWindowCapture::Error | error() const |
Señal del notificador:
| void | errorChanged() |
[read-only] errorString : QString
Esta propiedad contiene una cadena legible que describe la causa del error.
Funciones de acceso:
| QString | errorString() const |
Señal del notificador:
| void | errorChanged() |
window : QCapturableWindow
Esta propiedad contiene la ventana de captura.
Funciones de acceso:
| QCapturableWindow | window() const |
| void | setWindow(QCapturableWindow window) |
Señal del notificador:
| void | windowChanged(QCapturableWindow window) |
Véase también QWindowCapture::capturableWindows.
Documentación de las funciones miembro
[explicit] QWindowCapture::QWindowCapture(QObject *parent = nullptr)
Construye un nuevo objeto QWindowCapture con parent.
[override virtual noexcept] QWindowCapture::~QWindowCapture()
Destruye el objeto.
[static invokable] QList<QCapturableWindow> QWindowCapture::capturableWindows()
Devuelve una lista de objetos QCapturableWindow disponibles para captura.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[signal] void QWindowCapture::errorOccurred(QWindowCapture::Error error, const QString &errorString)
Señala cuándo se produce un error, junto con el errorString.
[slot] void QWindowCapture::start()
Inicia la captura de window.
Esto equivale a establecer la propiedad active en true.
[slot] void QWindowCapture::stop()
Detiene la captura.
Esto equivale a establecer la propiedad active en false.
© 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.
