Main Content

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

add

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

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

構文

add(report,content)

説明

メモ

add は推奨されません。代わりに append を使用してください。互換性の考慮事項を参照してください。

add(report,content) は、指定された content を指定されたレポートに追加します。レポートがまだ開いていない場合、add メソッドによってレポートが開かれます。

メモ

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

入力引数

すべて展開する

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

レポートに追加するコンテンツ。レポート 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

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

ReportChapter、または 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);