En esta página

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

Métodos

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.