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 では、Apache OpenOffice を /Applications フォルダーにインストールしなければなりません。

メモ

mlreportgen.report.Report クラスには、rptview という名前のメソッドがあります。mlreportgen.report.Report オブジェクトを引数値として rptview を呼び出すと、このメソッドが呼び出されます。他のすべてのタイプの引数値については、関数 rptview が呼び出されます。ヒントを参照してください。

例

rptview(reportPath) は、ファイル拡張子に基づいて、reportPath によって指定されたレポートを適切なビューアーに表示します。

例

rptview(reportName,format) は、format で指定された形式に基づいて、reportName によって指定されたレポートを適切なビューアーに表示します。

例

rptview(docxfile,"pdf") は、Microsoft Word レポートを PDF に変換し、PDF ビューアーでレポートを表示します。

メモ

この機能は Microsoft Windows® でのみ使用できます。Macintosh または Linux プラットフォームで実行している場合は、レポート API または 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");

名前が同じで、形式とコンテンツが異なる 2 つのレポートを作成します。適切なレポートを表示する形式を指定します。

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 オブジェクトとして指定します。

ファイル拡張子を含む、特定のレポート ファイルのパスと名前。文字ベクトルまたは string スカラーとして指定します。mlreportgen.dom.Document オブジェクトまたは mlreportgen.report.Report オブジェクトの OutputPath プロパティを使用して、reportPath を提供できます。

レポートが表示されるビューアーは、レポート ファイル名の拡張子によって決まります。

ファイル拡張子ビューアー

.htmx

MATLAB® WebWindow

.html

MATLAB WebWindow

.zip

MATLAB WebWindow

.docx

Microsoft Word

.pdf

PDF ビューアー

データ型: char | string

ファイル拡張子を含まない、レポートのパスとファイル名。文字ベクトルまたは 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 オブジェクトとして指定します。

ファイル拡張子を含む、特定のプレゼンテーション ファイルのパスと名前。文字ベクトルまたは string スカラーとして指定します。ファイル拡張子は、.pptx または .potx を使用できます。mlreportgen.ppt.Presentation オブジェクトの OutputPath プロパティを使用して、pptPath を提供できます。

データ型: char | string

制限

  • rptview は、MATLAB Online での PowerPoint (.ppt) レポートまたは Word (.docx) レポートの表示をサポートしていません。

  • rptview は MATLAB Web アプリではサポートされていません。

ヒント

メモ

mlreportgen.dom.Document オブジェクトの OpenStatus プロパティが "open" である場合、レポートを表示するために rptview を呼び出すと、OpenStatus が "closed" に設定されます。レポートを表示するには、DOM API の close コマンドを実行する必要があります。これにより、レポートのメモリ内の DOM 表現が、Type プロパティで指定されたタイプのファイルに変換されます。Document.OpenStatus が "closed" に設定されていない場合、rptview は必要な close コマンドを発行します。

mlreportgen.report.Report オブジェクトを引数値として rptview を呼び出すと、mlreportgen.report.Report オブジェクトの rptview メソッドが呼び出されます。rptview メソッドは、レポート オブジェクトの Document プロパティの値を引数値として関数 rptview を呼び出します。

mlreportgen.report.Report オブジェクト以外の引数値を使用して rptview を呼び出すと、関数 rptview が呼び出されます。

たとえば、以下のコードでは、最初の rptview の呼び出しによって rptview メソッドが呼びされます。2 番目の 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 で導入

参考

| | | |