QWindowCapture Class
Diese Klasse wird für die Erfassung eines Fensters verwendet. Mehr...
| Kopfzeile: | #include <QWindowCapture> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia)target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| Since: | Qt 6.6 |
| In QML: | WindowCapture |
| Vererbt: | QObject |
Öffentliche Typen
| enum | Error { NoError, InternalError, CapturingNotSupported, CaptureFailed, NotFound } |
Eigenschaften
- active : bool
- error : Error
- errorString : QString
- window : QCapturableWindow
Öffentliche Funktionen
| QWindowCapture(QObject *parent = nullptr) | |
| virtual | ~QWindowCapture() override |
| QWindowCapture::Error | error() const |
| QString | errorString() const |
| bool | isActive() const |
| void | setWindow(QCapturableWindow window) |
| QCapturableWindow | window() const |
Öffentliche Slots
Signale
| void | activeChanged(bool) |
| void | errorChanged() |
| void | errorOccurred(QWindowCapture::Error error, const QString &errorString) |
| void | windowChanged(QCapturableWindow window) |
Statische öffentliche Mitglieder
| QList<QCapturableWindow> | capturableWindows() |
Detaillierte Beschreibung
Die Klasse nimmt ein Fenster auf. Sie wird von der Klasse QMediaCaptureSession verwaltet, wo das erfasste Fenster in einem Videovorschauobjekt angezeigt oder in einer Datei aufgezeichnet werden kann.
Einschränkungen bei der Fenstererfassung
Die folgenden Einschränkungen gelten für die Verwendung von QWindowCapture:
- QWindowCapture wird nur mit dem FFmpeg Backend unterstützt.
Die folgenden Einschränkungen gelten bei der Verwendung von QWindowCapture auf X11-Systemen:
- Auf Linux X11-Systemen wird nur der sichtbare Bereich erfasst, wenn ein Fenster teilweise außerhalb des sichtbaren Bildschirmbereichs verschoben wird. Daher kann es vorkommen, dass die Größe der ausgegebenen Videobilder kleiner ist als die Geometrie des Fensters.
- Fenster, die außerhalb des sichtbaren Bildschirmbereichs liegen, können nicht erfasst werden, und in diesem Fall wird ein Fehlersignal ausgegeben.
- Das Verhalten von minimierten Fenstern oder solchen, die sich auf einer unsichtbaren virtuellen Arbeitsfläche befinden, hängt vom Fenstermanager ab. Beispielsweise können solche Fenster unter GNOME erfasst werden, während unter WindowMaker oder Xfwm ein solches Erfassen nicht erlaubt ist und die Fenstererfassungsinstanz einen Fehler ausgibt.
Siehe auch QMediaCaptureSession und QCapturableWindow.
Dokumentation der Mitgliedstypen
enum QWindowCapture::Error
Zählt die Fehlercodes auf, die von der Klasse QWindowCapture gemeldet werden können. errorString() liefert detaillierte Informationen über die Fehlerursache.
| Konstante | Wert | Beschreibung |
|---|---|---|
QWindowCapture::NoError | 0 | Kein Fehler |
QWindowCapture::InternalError | 1 | Interner Window-Capturing-Treiberfehler |
QWindowCapture::CapturingNotSupported | 2 | Fenstererfassung wird nicht unterstützt |
QWindowCapture::CaptureFailed | 4 | Fenstererfassung fehlgeschlagen |
QWindowCapture::NotFound | 5 | Ausgewähltes Fenster nicht gefunden |
Eigenschaft Dokumentation
active : bool
Diese Eigenschaft gibt an, ob die Aufzeichnung gerade aktiv ist.
Zugriffsfunktionen:
| bool | isActive() const |
| void | setActive(bool active) |
Melder-Signal:
| void | activeChanged(bool) |
Siehe auch start() und stop().
[read-only] error : Error
Diese Eigenschaft enthält den Code des letzten Fehlers.
Zugriffsfunktionen:
| QWindowCapture::Error | error() const |
Benachrichtigungssignal:
| void | errorChanged() |
[read-only] errorString : QString
Diese Eigenschaft enthält eine von Menschen lesbare Zeichenfolge, die die Fehlerursache beschreibt.
Zugriffsfunktionen:
| QString | errorString() const |
Benachrichtigungssignal:
| void | errorChanged() |
window : QCapturableWindow
Diese Eigenschaft enthält das Fenster für die Erfassung.
Zugriffsfunktionen:
| QCapturableWindow | window() const |
| void | setWindow(QCapturableWindow window) |
Melder-Signal:
| void | windowChanged(QCapturableWindow window) |
Siehe auch QWindowCapture::capturableWindows.
Dokumentation der Mitgliedsfunktionen
[explicit] QWindowCapture::QWindowCapture(QObject *parent = nullptr)
Konstruiert ein neues QWindowCapture-Objekt mit parent.
[override virtual noexcept] QWindowCapture::~QWindowCapture()
Zerstört das Objekt.
[static invokable] QList<QCapturableWindow> QWindowCapture::capturableWindows()
Gibt eine Liste von QCapturableWindow Objekten zurück, die für die Erfassung verfügbar sind.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[signal] void QWindowCapture::errorOccurred(QWindowCapture::Error error, const QString &errorString)
Signalisiert, wenn eine error auftritt, zusammen mit der errorString.
[slot] void QWindowCapture::start()
Startet die Erfassung der window.
Dies ist gleichbedeutend mit der Einstellung der Eigenschaft active auf true.
[slot] void QWindowCapture::stop()
Stoppt die Aufzeichnung.
Dies entspricht der Einstellung der Eigenschaft active auf 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.
