add

クラス: mlreportgen.report.Report
名前空間: mlreportgen.report

(非推奨) レポートへのコンテンツの追加

構文

add(report,content)

説明

メモ

add は推奨されません。代わりに append を使用してください。バージョン履歴を参照してください。

add(report,content) は指定された content をレポートに追加します。レポートのステータスが "unopened" の場合、add メソッドはステータスを "open" に設定し、コンテンツを追加します。レポートのステータスが "closed" に設定されている場合、add メソッドはエラーメッセージを返します。レポートのステータスに関する詳細については、OpenStatus を参照してください。

メモ

レポーターをレポートに複数回追加できますが、そのレポーターを別のレポートに追加することはできません。たとえば、あるレポートに mlreportgen.report.TitlePage レポーターを追加する場合、そのレポーターを他のレポートに追加することはできません。

入力引数

すべて展開する

`report` — レポート
`mlreportgen.report.Report` オブジェクト

レポート。mlreportgen.report.Report オブジェクトとして指定します。

`content` — レポートに追加するコンテンツ
レポート API レポーター | DOM オブジェクト | MATLAB 組み込みオブジェクト

レポートに追加するコンテンツ。レポート API レポーター、DOM オブジェクト、または組み込み MATLAB^® オブジェクトとして指定します。コンテンツは、レポート API レポーター、または DOM ドキュメントに追加できる任意のオブジェクトです。DOM ドキュメントに追加できるコンテンツには、DOM オブジェクトと多くの組み込み MATLAB オブジェクト (string、文字ベクトル、cell 配列など) が含まれます。

例

すべて展開する

レポートへのコンテンツの追加

段落にコンテンツを追加し、レポートに段落を追加します。段落は DOM API オブジェクトであるため、段落にコンテンツを追加するには、append を使用しなければなりません。この例では、レポート API オブジェクトであるレポートに段落を追加するために、add を使用します。R2020b 以降では、add の代わりに append を使用できます。バージョン履歴を参照してください。

import mlreportgen.dom.*
import mlreportgen.report.*

rpt = Report("My Report");
p = Paragraph("My paragraph content ");

append(p,"and some more content.");
add(rpt,p);

close(rpt);
rptview(rpt);

バージョン履歴

R2017b で導入

すべて折りたたむ

R2020b: `add` メソッドは非推奨

R2020b 以降では、以下のレポート API クラスのオブジェクトにコンテンツを追加する場合、add メソッドの代わりに append メソッドを使用してください。

mlreportgen.report.Report
mlreportgen.report.Chapter
mlreportgen.report.Section
slreportgen.report.Report

mlreportgen.dom.Paragraph オブジェクトなどの DOM API オブジェクトにコンテンツを追加するには、引き続き DOM オブジェクトの append メソッドを使用してください。レポート API オブジェクトへのコンテンツの追加に append を使用することの利点は、DOM API オブジェクトへのコンテンツの追加に使用するのと同じメソッド名を使用できることです。

Report、Chapter、または Section クラスの add メソッドが削除される予定はありません。add メソッドを使用するレポート API プログラムは引き続き動作します。

既存のコードを更新するには、表の例に示すように、メソッド名を add から append に置き換えます。

非推奨	推奨
import mlreportgen.report.* import mlreportgen.dom.* rpt = Report("My Report","pdf"); ch = Chapter("My Chapter"); sect = Section("My Section"); para = Paragraph("My Content "); append(para,"more Content"); add(sect,para); add(ch,sect); add(rpt,ch); close(rpt); rptview(rpt);	import mlreportgen.report.* import mlreportgen.dom.* rpt = Report("My Report","pdf"); ch = Chapter("My Chapter"); sect = Section("My Section"); para = Paragraph("My Content "); append(para,"more Content"); append(sect,para); append(ch,sect); append(rpt,ch); close(rpt); rptview(rpt);

非推奨

推奨

import mlreportgen.report.*
import mlreportgen.dom.*

rpt = Report("My Report","pdf");
ch = Chapter("My Chapter");
sect = Section("My Section");
para = Paragraph("My Content ");
append(para,"more Content");
add(sect,para);
add(ch,sect);
add(rpt,ch);

close(rpt);
rptview(rpt);

import mlreportgen.report.*
import mlreportgen.dom.*

rpt = Report("My Report","pdf");
ch = Chapter("My Chapter");
sect = Section("My Section");
para = Paragraph("My Content ");
append(para,"more Content");
append(sect,para);
append(ch,sect);
append(rpt,ch);

close(rpt);
rptview(rpt);

参考

mlreportgen.report.Report | append | open | close | rptview

トピック

レポートへのコンテンツの追加

add

構文

説明