QWindowCapture 类
此类用于捕获窗口。 更多...
| 头文件 | #include <QWindowCapture> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake | QT += multimedia |
| 自 | Qt 6.6 |
| 由以下类实例化 | WindowCapture |
| 继承自 | QObject |
公共类型
| 枚举 | Error { NoError, InternalError, CapturingNotSupported, CaptureFailed, NotFound } |
属性
- active : bool
- error : const Error
- errorString : const QString
- window : QCapturableWindow
公共函数
| QWindowCapture(QObject *parent = nullptr) | |
| virtual | ~QWindowCapture() override |
| QWindowCapture::Error | error() const |
| QString | errorString() const |
| bool | isActive() const |
| void | setWindow(QCapturableWindow window) |
| QCapturableWindow | window() const |
公共槽
信号
| void | activeChanged(bool) |
| void | errorChanged() |
| void | errorOccurred(QWindowCapture::Error error, const QString &errorString) |
| void | windowChanged(QCapturableWindow window) |
静态公共成员
| QList<QCapturableWindow> | capturableWindows() |
详细描述
该类用于捕获窗口。它由 QMediaCaptureSession 类管理，其中捕获的窗口可以显示在视频预览对象中或记录到文件中。
也见QMediaCaptureSession 和 QCapturableWindow。
成员类型文档
枚举 QWindowCapture::Error
列出由 QWindowCapture 类可能发出的错误代码。 errorString() 提供有关错误原因的详细信息。
| 常量 | 值 | 描述 |
|---|---|---|
QWindowCapture::NoError | 0 | 无错误 |
QWindowCapture::InternalError | 1 | 内部窗口捕捉驱动程序错误 |
QWindowCapture::CapturingNotSupported | 2 | 不支持窗口捕捉 |
QWindowCapture::CaptureFailed | 4 | 窗口捕捉失败 |
QWindowCapture::NotFound | 5 | 未找到所选窗口 |
属性文档
active : bool
此属性表示捕捉当前是否活动。
访问函数
| bool | isActive() const |
| void | setActive(bool active) |
通知信号
| void | activeChanged(bool) |
[只读] error : const Error
此属性保存了最后错误代码。
访问函数
| QWindowCapture::Error | error() const |
通知信号
| void | errorChanged() |
[只读] errorString : const QString
此属性包含描述错误原因的易于阅读的字符串。
访问函数
| QString | errorString() const |
通知信号
| void | errorChanged() |
window : QCapturableWindow
此属性包含用于捕捉的窗口。
访问函数
| QCapturableWindow | window() const |
| void | setWindow(QCapturableWindow window) |
通知信号
| void | windowChanged(QCapturableWindow window) |
成员函数文档
[显式] QWindowCapture::QWindowCapture(QObject *parent = nullptr)
使用父对象parent构建一个新的QWindowCapture对象。
[重载虚函数 noexcept] QWindowCapture::~QWindowCapture()
销毁对象。
[静态可调用] QList<QCapturableWindow> QWindowCapture::capturableWindows()
返回一个可用的QCapturableWindow对象列表。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[信号] void QWindowCapture::errorOccurred(QWindowCapture::Error error, const QString &errorString)
当发生错误时发出信号，以及errorString。
[槽] void QWindowCapture::start()
开始捕捉窗口。
这等价于将active属性设置为true。
[槽] void QWindowCapture::stop()
停止捕捉。
这等价于将active属性设置为false。
© 2024 Qt公司有限公司。本文档中包含的贡献内容均为相应所有者的版权。提供的文档根据 Free Software Foundation 发布的 GNU自由文档许可协议第1.3版 条款进行授权。Qt及其相关标志是芬兰以及全球其他国家的Qt公司有限公司的商标。所有其他商标均为其相应所有者的财产。
