WindowCapture QML Type
Ce type est utilisé pour capturer une fenêtre. Plus d'informations...
| Import Statement: | import QtMultimedia |
| Since: | Qt 6.6 |
| In C++: | QWindowCapture |
Propriétés
- active : bool
- error : enumeration
- errorString : string
- window : Window
Méthodes
- list<CapturableWindow> capturableWindows()
- void start()
- void stop()
Description détaillée
WindowCapture capture une fenêtre. Elle est gérée par MediaCaptureSession où la fenêtre capturée peut être affichée dans un objet de prévisualisation vidéo ou enregistrée dans un fichier.
Limites de la capture de fenêtre
Les limitations suivantes s'appliquent à l'utilisation de WindowCapture :
- La capture de fenêtre n'est prise en charge qu'avec le backend FFmpeg.
Les limitations suivantes s'appliquent à l'utilisation de QWindowCapture sur les systèmes X11 :
- Sur les systèmes Linux X11, lorsqu'une fenêtre est déplacée partiellement en dehors de la zone visible de l'écran, seule la zone visible est capturée. Par conséquent, les images vidéo émises peuvent avoir une taille inférieure à la géométrie de la fenêtre.
- Les fenêtres situées en dehors de la zone visible de l'écran ne peuvent pas être capturées et un signal d'erreur est émis dans ce cas.
- Le comportement des fenêtres réduites ou situées sur un espace de travail virtuel invisible dépend du gestionnaire de fenêtres. Par exemple, de telles fenêtres peuvent être capturées sous GNOME, alors que sous WindowMaker ou Xfwm une telle capture n'est pas autorisée, et l'instance de capture de fenêtre émet une erreur.
Voir également CaptureSession et CapturableWindow.
Documentation sur les propriétés
active : bool
Indique si la capture est actuellement active.
error : enumeration [read-only]
Renvoie le code de la dernière erreur.
errorString : string [read-only]
Renvoie une chaîne lisible par l'homme décrivant la cause de l'erreur.
window : Window
Décrit la fenêtre de capture.
Voir également QtMultimedia::WindowCapture::capturableWindows.
Documentation de la méthode
list<CapturableWindow> capturableWindows()
Renvoie une liste d'objets CapturableWindow disponibles pour la capture.
void start()
Commence à capturer le site window.
Cela équivaut à définir la propriété active sur true.
void stop()
Arrête la capture.
Cela équivaut à définir la propriété active sur 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.