WindowCapture QML Type
Este tipo se utiliza para capturar una ventana. Más...
| Import Statement: | import QtMultimedia |
| Since: | Qt 6.6 |
| In C++: | QWindowCapture |
Propiedades
- active : bool
- error : enumeration
- errorString : string
- window : Window
Métodos
- list<CapturableWindow> capturableWindows()
- void start()
- void stop()
Descripción detallada
WindowCapture captura una ventana. Se gestiona mediante MediaCaptureSession, donde la ventana capturada puede mostrarse en un objeto de previsualización de vídeo o grabarse en un archivo.
Limitaciones de WindowCapture
Las siguientes limitaciones se aplican al uso de WindowCapture:
- WindowCapture 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 CaptureSession y CapturableWindow.
Documentación de propiedades
active : bool
Describe si la captura está actualmente activa.
error : enumeration [read-only]
Devuelve un código del último error.
errorString : string [read-only]
Devuelve una cadena legible que describe la causa del error.
window : Window
Describe la ventana de captura.
Véase también QtMultimedia::WindowCapture::capturableWindows.
Documentación del método
list<CapturableWindow> capturableWindows()
Devuelve una lista de objetos CapturableWindow que está disponible para capturar.
void start()
Inicia la captura de window.
Esto equivale a establecer la propiedad active en true.
void 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.