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 : const Error
- errorString : const 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.
Siehe auch QMediaCaptureSession und QCapturableWindow.
Dokumentation der Membertypen
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 : const Error
Diese Eigenschaft enthält den Code des letzten Fehlers.
Zugriffsfunktionen:
| QWindowCapture::Error | error() const |
Benachrichtigungssignal:
| void | errorChanged() |
[read-only] errorString : const 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.
© 2025 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.
