Main Content

add

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

(非推奨) 節へのコンテンツの追加

構文

add(section,content)

説明

メモ

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

add(section,content) は、指定されたコンテンツを指定された節に追加します。

入力引数

すべて展開する

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

節に追加するコンテンツ。以下のいずれかの値として指定します。

  • レポート API レポーター

  • DOM オブジェクト

  • 組み込み MATLAB® オブジェクト (組み込み MATLAB オブジェクトのほとんどは Section レポーターに追加可能)

  • 節に個別に追加できるオブジェクトの cell 配列

すべて展開する

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

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

rpt = Report("My Report");
ch = Chapter("My Chapter");
s = Section("My Section");
p = Paragraph("My paragraph content ");
append(p,"and some more content.");
add(s,p);
add(ch,s);
add(rpt,ch);

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);