mlreportgen.utils.powerpoint 类

命名空间: mlreportgen.utils

与 PowerPoint 应用程序和演示文稿进行交互

描述

该实用工具提供与 PowerPoint^® 应用程序和 PowerPoint 演示文稿交互的方法。这些方法使用 Microsoft .NET 框架的 MATLAB 接口与 PowerPoint 编辑器进行交互。

方法

公共方法

`start`	pptApp = mlreportgen.utils.powerpoint.start() 如果尚未启动，则启动 PowerPoint 应用程序并返回 `pptApp` 对象。`pptApp` 对象是包装了 PowerPoint 编辑器的 .NET 对象的 MATLAB 对象。PowerPoint 应用程序已被隐藏。
`load`	pptPres = mlreportgen.utils.powerpoint.load(filename) 加载 `filename` 中指定的现有 PowerPoint 演示文稿文件并返回 `pptPres` 对象。`pptPres` 对象是包装 PowerPoint 演示文稿的 .NET 对象的 MATLAB 对象。
`open`	pptPres = mlreportgen.utils.powerpoint.open(filename) 打开 `filename` 中指定的 PowerPoint 演示文稿文件，使其可见，并返回 `pptPres` 对象。`pptPres` 对象是包装 PowerPoint 演示文稿的 .NET 对象的 MATLAB 对象。
`close`	tf = mlreportgen.utils.powerpoint.close tf = mlreportgen.utils.powerpoint.close(true) tf = mlreportgen.utils.powerpoint.close(false) 对于空或无输入，仅当没有未保存的 PowerPoint 演示文稿时才关闭 PowerPoint 应用程序。对于 `true` 输入，仅当没有未保存的 PowerPoint 演示文稿时才关闭 PowerPoint 应用程序。对于 `false` 输入，即使有未保存的 PowerPoint 演示文稿或在 MATLAB 之外打开了 PowerPoint 演示文稿，也要关闭 PowerPoint 应用程序。对于每个语法，如果应用程序已关闭则返回 `true`，如果应用程序保持打开状态则返回 `false`。 tf = mlreportgen.utils.powerpoint.close(filename) tf = mlreportgen.utils.powerpoint.close(filename,true) tf = mlreportgen.utils.powerpoint.close(filename,false) 对于 `filename` 输入，仅当没有未保存的更改时才关闭指定为 `filename` 的 PowerPoint 演示文稿。对于 `filename` 和 `true` 输入，仅当没有未保存的更改时才关闭 PowerPoint 演示文稿（指定为 `filename`）。对于 `filename` 和 `false` 输入，关闭 PowerPoint 演示文稿（指定为 `filename`），即使存在未保存的更改。对于每个语法，如果没有其他打开的 PowerPoint 演示文稿，则隐藏 PowerPoint 应用程序。如果 PowerPoint 演示文稿文件已关闭，则返回 `true` 如果 PowerPoint 演示文稿文件保持打开状态，则返回 `false`
`closeAll`	tf = mlreportgen.utils.powerpoint.closeAll() tf = mlreportgen.utils.powerpoint.closeAll(true) tf = mlreportgen.utils.powerpoint.closeAll(false) 对于空输入，关闭所有 PowerPoint 演示文稿文件并隐藏 PowerPoint 应用程序。对于 `true` 输入，仅当没有未保存的更改时才关闭所有 PowerPoint 演示文稿。对于 `false` 输入，关闭所有 PowerPoint 演示文稿文件，即使有未保存的更改。对于每个语法：如果没有其他打开的 PowerPoint 演示文稿文件，则隐藏 PowerPoint 应用程序如果所有 PowerPoint 演示文稿文件都已关闭，则返回 `true` 如果任何 PowerPoint 演示文稿文件保持打开状态，则返回 `false`
`show`	pptApp = mlreportgen.utils.powerpoint.show() pptPres = mlreportgen.utils.powerpoint.show(filename) 对于空输入，使 PowerPoint 应用程序或 PowerPoint 演示文稿文件可见并返回 `pptApp` 对象。对于 `filename` 输入，使指定的 PowerPoint 演示文稿文件可见并返回 `pptPres` 对象。
`hide`	pptApp = mlreportgen.utils.powerpoint.hide() pptPres = mlreportgen.utils.powerpoint.hide(filename) 对于空输入，隐藏 PowerPoint 应用程序或 PowerPoint 演示文稿并返回 `pptApp` 对象。对于 `filename` 输入，隐藏指定的 PowerPoint 演示文稿文件并返回 `pptPres` 对象。
`isAvailable`	tf = mlreportgen.utils.powerpoint.isAvailable() 验证 PowerPoint 是否可供使用。如果 PowerPoint 可用则返回 `true`，如果不可用则返回 `false`。
`isStarted`	tf = mlreportgen.utils.powerpoint.isStarted 验证 PowerPoint 应用程序是否已启动。如果 PowerPoint 已启动则返回 `true`，如果未启动则返回 `false`。
`isLoaded`	tf = mlreportgen.utils.powerpoint.isLoaded(filename) 验证 PowerPoint 演示文稿文件是否已加载。如果 PowerPoint 演示文稿 `true` 已加载，则返回 `filename`，如果未加载，则返回 `false`。
`pptapp`	pptApp = mlreportgen.utils.powerpoint.pptApp() 返回 `pptApp` 对象。如果 PowerPoint 未启动，则会发生错误。
`pptpres`	pptPres = mlreportgen.utils.powerpoint.pptPres(filename) 返回包装 `pptPres` 中指定的 PowerPoint 演示文稿文件的 `filename` 对象。如果 PowerPoint 演示文稿文件不存在，则会发生错误。

示例

打开 PowerPoint 演示文稿

打开当前工作文件夹中的 test.pptx 和 test1.pptx PowerPoint 演示文稿。

pptPres = mlreportgen.utils.powerpoint.open("test")
pptPres1 = mlreportgen.utils.powerpoint.open("test1")

pptPres = 

  PPTPres with properties:
    FileName: "C:\Users\username\Documents\test.pptx"

pptPres1 = 

  pptPres with properties:
    FileName: 'C:\Users\username\Documents\test1.pptx'

获取 PowerPoint 演示文稿文件名

获取打开的 PowerPoint 演示文稿文件的名称。

files = mlreportgen.utils.powerpoint.filenames()

files = 

  1×2 string array

    "C:\Users\username\Documents\test.pptx" ...
    "C:\Users\username\Documents\test1.pptx"

限制

mlreportgen.utils.powerpoint 仅在 Microsoft^® Windows^® 上可用。
MATLAB^® Web App 不支持 mlreportgen.utils.powerpoint。

版本历史记录

在 R2018b 中推出

另请参阅

mlreportgen.utils.PPTPres | mlreportgen.utils.PPTApp

主题

Microsoft .NET 快速入门