本页采用了机器翻译。点击此处可查看英文原文。

rptview

显示报告或演示文稿

全页折叠

语法

rptview(domObj)
rptview(reportPath)
rptview(reportName,format)
rptview(docxfile,"pdf")
rptview(pptObj)
rptview(pptPath)

说明

rptview(domObj) 在适当的查看器中显示输入 mlreportgen.dom.Document 对象指定的报告。

在 Linux® 或 Macintosh 平台上打开 Microsoft® Word 文档会调用 soffice 命令。要在 Linux 计算机上使用 soffice 命令，必须安装 Apache® OpenOffice® 或 LibreOffice®。在 Macintosh 上，您必须在 /Applications 文件夹中安装 Apache OpenOffice。

注意

mlreportgen.report.Report 类有一个名为 rptview 的方法。当您使用 mlreportgen.report.Report 对象作为参量值调用 rptview 时，该方法被调用。对于所有其他类型的参量值，将调用 rptview 函数。请参阅提示。

示例

rptview(reportPath) 根据文件扩展名在适当的查看器中显示 reportPath 指定的报告。

示例

rptview(reportName,format) 根据 reportName 中指定的格式，在适当的查看器中显示 format 指定的报告。

示例

rptview(docxfile,"pdf") 将 Microsoft Word 报告转换为 PDF 并在 PDF 查看器中显示该报告。

注意

此函数仅在 Microsoft Windows® 上可用。如果您在 Macintosh 或 Linux 平台上运行，则必须使用报告或 DOM API 直接生成 PDF。

示例

rptview(pptObj) 在 Microsoft PowerPoint® 中显示输入 mlreportgen.ppt.Presentation 对象指定的呈现方式。

要在 Linux 或 Macintosh 平台上打开演示文稿，rptview 会调用 soffice 命令。在 Linux 上，必须安装 Apache OpenOffice 或 LibreOffice。在 Macintosh 上，Apache OpenOffice 必须安装在 /Applications 文件夹中。

示例

rptview(pptPath) 显示位于 Microsoft PowerPoint 中 pptPath 处的演示文稿。

示例

示例

全部折叠

显示使用 mlreportgen.dom.Document 对象生成的 HTML 报告。

import mlreportgen.dom.*;
d = Document("mydoc");

p = Paragraph("Hello World");
append(d,p);

close(d);
rptview("mydoc");

显示使用 mlreportgen.dom.Document 对象生成的 PDF 报告。

import mlreportgen.dom.*;
d = Document("mydoc","pdf");

append(d, "Hello World");

close(d);
rptview(d);

显示使用 mlreportgen.report.Report 对象生成的报告。使用对象的 OutputPath 属性值指定报告的路径和文件名。

import mlreportgen.dom.*;
import mlreportgen.report.*;
rpt = Report("myReport","docx");

p = Paragraph("Hello World");
add(rpt,p);
close(rpt);
rptview(rpt.OutputPath);

使用 rptview 函数将 Word 报告转换为 PDF 并在 PDF 查看器中显示它。

import mlreportgen.dom.*;
import mlreportgen.report.*;
rpt = Report("myReport","docx");

p = Paragraph("Hello World");
add(rpt,p);

close(rpt);
rptview("myReport.docx","pdf");

创建两个名称相同但格式和内容不同的报告。指定显示适当报告的格式。

import mlreportgen.dom.*;
import mlreportgen.report.*
rpt = Report("myReport","html");

p = Paragraph("Hello World");
add(rpt,p);
close(rpt);

rptWord = Report("myReport","docx");
p = Paragraph("Hello again, World");
add(rptWord,p);
close(rptWord);

rptview("myReport","docx");

通过使用 mlreportgen.ppt.Presentation 对象的名称调用 rptview 来显示演示文稿。

import mlreportgen.ppt.*
ppt = Presentation("MyPresentation");
open(ppt);

slide1 = add(ppt,"Title and Table");
replace(slide1,"Title","Magic Square Slide 1");
replace(slide1,"Table",Table(magic(3)));
close(ppt);
rptview(ppt);

通过使用生成的 PowerPoint 演示文稿的路径和文件名（包括扩展名）调用 rptview 来显示演示文稿。

import mlreportgen.ppt.*
ppt = Presentation("MyPresentation");
open(ppt);

slide1 = add(ppt,"Title and Table");
replace(slide1,"Title","Magic Square Slide 1");
replace(slide1,"Table",Table(magic(3)));
close(ppt);
rptview("MyPresentation.pptx");

输入参数

全部折叠

生成要查看的报告的文档对象，指定为 mlreportgen.dom.Document 对象。

特定报告文件的路径和名称，包括文件扩展名，指定为字符向量或字符串标量。您可以使用 mlreportgen.dom.Document 对象或 mlreportgen.report.Report 对象的 OutputPath 属性来提供 reportPath。

报告文件扩展名决定了报告显示的查看器。

文件扩展名查看器

.htmx

MATLAB® Web 窗口

.html

MATLAB Web 窗口

.zip

MATLAB Web 窗口

.docx

Microsoft Word

.pdf

PDF 查看器

数据类型: char | string

报告的路径和文件名（不带文件扩展名），指定为字符向量或字符串标量。

数据类型: char | string

报告输出格式，指定为以下值之一：

  • "docx" 用于 Microsoft Word

  • "html" 用于 HTML 输出

  • "html-file" 用于单文件 HTML 输出

  • "html-multipage" 用于多页 HTML 输出 (自 R2024a 起)

  • "pdf" 用于 PDF 输出

  • "pdfa" 用于 PDF/A 输出 (自 R2025a 起)

数据类型: char | string

要转换为 PDF 的 Word .docx 文件，指定为具有 .docx 扩展名的 Word 文件。

数据类型: char | string

生成要查看的演示文稿的演示对象，指定为 mlreportgen.ppt.Presentation 对象。

特定演示文稿文件的路径和名称，包括文件扩展名，指定为字符向量或字符串标量。文件扩展名可以是 .pptx 或 .potx。您可以使用 mlreportgen.ppt.Presentation 对象的 OutputPath 属性来提供 pptPath。

数据类型: char | string

限制

  • rptview 不支持在 MATLAB Online 中查看 PowerPoint (.ppt) 或 Word (.docx) 报告。

  • MATLAB Web App 不支持 rptview。

提示

注意

如果 mlreportgen.dom.Document 对象的 OpenStatus 属性是 "open" 并且您调用 rptview 来查看报告，则 OpenStatus 将被设置为 "closed"。显示报告需要执行 DOM API 的 close 命令，该命令将报告的内存 DOM 表示转换为 Type 属性指定类型的文件。如果 Document.OpenStatus 尚未准备好设置为 "closed" ，则 rptview 会为您发出所需的关闭命令。

使用 mlreportgen.report.Report 对象作为参量值调用 rptview，将调用 mlreportgen.report.Report 对象的 rptview 方法。rptview 方法使用报告对象的 Document 属性值作为参量值来调用 rptview 函数。

使用 mlreportgen.report.Report 对象以外的参量值调用 rptview 会调用 rptview 函数。

例如，在下面的代码中，第一个 rptview 调用调用 rptview 方法。第二个 rptview 调用调用 rptview 函数。

import mlreportgen.report.*
rpt = Report("myReport","pdf");
add(rpt, "Hello World");
close(rpt);
% Invokes rptview method
rptview(rpt);
% Invokes rptview function  
rptview("myReport.pdf");

版本历史记录

在 R2014b 中推出

另请参阅

| | | |