class QWindowCapture

此类用于捕获窗口。 更多…

自版本 6.6起新增。

摘要

属性

• active - 是否当前正在捕获

• error - 最后错误的代码

• errorString - 描述错误原因的易读字符串

• windowᅟ - 捕获的窗口

方法

• def __init__()

• def captureSession()

• def error()

• def errorString()

• def isActive()

• def setWindow()

• def window()

槽

• def setActive()

• def start()

• def stop()

信号

• def activeChanged()

• def errorChanged()

• def errorOccurred()

• def windowChanged()

静态函数

• def capturableWindows()

注意

本文档可能包含从 C++ 自动转换到 Python 的代码段。我们始终欢迎对代码段翻译的贡献。如果您在翻译中发现问题，也可以通过在 https:/bugreports.qt.io/projects/PYSIDE 上创建工单来告诉我们

详细描述

该类捕获窗口。它由管理捕获窗口的 QMediaCaptureSession 类进行管理，捕获的窗口可以显示在视频预览对象中，或录制到文件中。

另请参阅

QMediaCaptureSession QCapturableWindow

class 错误

枚举了由 QWindowCapture 类可能发出的错误代码。通过 errorString() 可以获取关于错误原因的详细信息。

常数	说明
QWindowCapture.NoError	无错误
QWindowCapture.InternalError	内部窗口捕获驱动程序错误
QWindowCapture.CapturingNotSupported	不支持窗口捕获
QWindowCapture.CaptureFailed	捕获窗口失败
QWindowCapture.NotFound	找不到选定的窗口

注意

当使用 from __feature__ import true_property 时，可以直接使用属性，否则通过访问函数进行。

property active: bool

该属性表示捕获是否当前活动状态。

另请参阅

start() stop()

访问函数

• isActive()

• setActive()

• 信号 activeChanged()

property error: QWindowCapture.Error

该属性持有上次错误的代码。

访问函数

• error()

• 信号 errorChanged()

property errorString: str

该属性持有描述错误原因的可读字符串。

访问函数

• errorString()

• 信号 errorChanged()

property window: QCapturableWindow

该属性持有用于捕获的窗口。

另请参阅

capturableWindows

访问函数

• window()

• setWindow()

• 信号 windowChanged()

__init__([parent=None])

参数:

parent – QObject

使用parent构建一个新的QWindowCapture对象。

activeChanged(arg__1)

参数:

arg__1 – bool

属性active的通知信号。

静态 capturableWindows()

返回类型:

QCapturableWindow对象列表

返回一个可用于捕获的QCaptorableWindow对象列表。

captureSession()

返回类型:

QMediaCaptureSession

error()

返回类型:

错误

属性error的获取器。

errorChanged()

属性error的通知信号。

errorOccurred(error, errorString)

参数:

• error – Error

• errorString – str

当发生错误时，会发出信号，并附带错误字符串。

errorString()

返回类型:

str

属性errorString的获取器。

isActive()

返回类型:

bool

属性active的获取器。

setActive(active)

参数:

active - 布尔类型

另请参阅

isActive()

属性 active 的设置器。

setWindow(window)

参数:

window - QCapturableWindow

另请参阅

window()

属性 window 的设置器。

start()

开始捕获 window。

这相当于将 active 属性设置为 true。

stop()

停止捕获。

这相当于将 active 属性设置为 false。

window()

返回类型:

QCapturableWindow

另请参阅

setWindow()

属性 window 的获取器。

windowChanged(window)

参数:

window - QCapturableWindow

属性 window 的通知信号。