matlab.unittest.diagnostics.ScreenshotDiagnostic 类
命名空间: matlab.unittest.diagnostics
可将屏幕捕获为图像文件的诊断
描述
使用 ScreenshotDiagnostic
类创建一个诊断,该诊断将可用屏幕捕获为图像文件。这些文件在 MATLAB® 完成测试运行后仍然存在,因此可用于测试后检查。
构造
ScreenshotDiagnostic()
会创建一个诊断,该诊断将可用屏幕捕获为图像文件。当测试框架诊断 ScreenshotDiagnostic
实例时,它会将屏幕截图保存为 PNG 文件。这些文件都具有唯一的名称,名称由前缀(默认为 Screenshot_'
)、自动生成的标识符和文件扩展名组成。例如文件名 Screenshot_cf95fe7f-5a7c-4310-9c49-16c0c18a969f.png
。要查看文件的位置,请通过 TestResult
实例访问 FileArtifact
对象。
ScreenshotDiagnostic('Prefix',
将创建一个诊断,该诊断将屏幕截图保存到名称以指定前缀开头的文件中。prefix
)
输入参数
属性
复制语义
句柄。要了解句柄类如何影响复制操作,请参阅复制对象。
示例
提示
保存屏幕截图的位置是一个文件夹,其名称对测试运行具有唯一性,位于
ArtifactsRootFolder
包含的文件夹中。以交互方式运行测试时,根文件夹的位置是tempdir()
返回的值。要确定保存屏幕截图的路径,请访问具体测试结果的
FileArtifact
对象。例如,假定您有一个TestResult
数组res
。按如下所示确定该数组第一个元素的图窗保存位置。res(1).Details.DiagnosticRecord.TestDiagnosticResults.Artifacts
ans = FileArtifact with properties: Name: "Screenshot_f51601ef-86bc-499c-bcec-203969f72a85.png" Location: "C:\work\Temp\1f4d3b64-3201-4bde-92ed-ad6859e97051" FullPath: "C:\work\Temp\1f4d3b64-3201-4bde-92ed-ad6859e97051\Screenshot_f51601ef-86bc-499c-bcec-203969f72a85.png"
如果您使用的是 macOS 系统,请在系统偏好设置中,允许终端 App 录制您的屏幕内容。当
ScreenshotDiagnostic
将屏幕捕获为图像文件时,此权限使其能够包含打开的窗口,如 MATLAB 桌面。
版本历史记录
在 R2017a 中推出