mlreportgen.report.Section クラス

名前空間: mlreportgen.report
スーパークラス: mlreportgen.report.Reporter

セクション レポーター

このページをすべて展開する

説明

レポートにセクションを追加するセクション レポーターを作成します。このクラスは mlreportgen.report.Reporter から継承します。

mlreportgen.report.Section クラスは handle クラスです。

クラス属性

HandleCompatible
true

クラス属性の詳細については、クラスの属性を参照してください。

作成

説明

section = Section は、レポート セクションを生成するレポーターを作成します。セクション レポーターをレポート、章、または別の節に追加できます。レポートにセクションを追加すると、既定の余白とページ番号付きのフッターが設定された縦向きの新規ページで、セクションが開始されます。ページ番号は、前のページ番号に 1 を加えたものになります。セクションを章または別の節に追加すると、レポーターは現在のページに、前に続く小節を作成します。既定では、タイトルのサイズがレポート階層のセクションの深さ (最大 5 レベル) に応じて小さくなります。5 よりも下層のセクションのタイトルには番号が付けられず、レベル 5 と同じフォント サイズになります。

section = Section(title) は、指定されたタイトル テキストのセクション タイトルを含むレポート セクションを作成します。既定では、階層セクション番号がタイトル テキストの前に付けられます。たとえば、2 番目の章で最初の節に付く既定の番号は 2.1 です。既定では、タイトルのフォント サイズがレポート階層のセクションの深さ (最大 5 レベル) に応じて小さくなります。

section = Section(PropertyName=Value) は、名前と値の引数を使用してプロパティを設定します。複数の名前と値の引数を任意の順番で指定できます。

例

プロパティ

すべて展開する

セクション タイトル。次のいずれかの値として指定します。

  • 文字ベクトルまたは string スカラー

  • DOM オブジェクト

  • string スカラーまたは DOM オブジェクトからなる 1 行 N 列または N 行 1 列の配列

  • string スカラー、文字ベクトル、および DOM オブジェクトからなる 1 行 N 列または N 行 1 列の cell 配列

  • getTitleReporter メソッドによって返される mlreportgen.report.Title オブジェクト

インライン オブジェクトは、段落に含めることができるオブジェクトです。タイトルの値がインライン オブジェクトの場合、セクション オブジェクトはテンプレートのセットから 1 つのテンプレートを使用します。テンプレートは、セクション用のテンプレート ライブラリに保存されます。タイトルの作成に使用されるテンプレートは、タイトルに番号が付けられているかどうか、およびセクション階層のセクション レベルによって異なります。Numbered プロパティを使用して、セクション タイトルに番号を付けるかどうかを指定します。

タイトルの値が DOM 段落または他の DOM ブロック オブジェクトである場合、セクションはセクションの先頭にオブジェクトを挿入します。DOM ブロック オブジェクトを使用する場合、ブロック要素を使用して、セクション タイトルの間隔、配置、およびその他のプロパティをカスタマイズできます。この場合、タイトル書式をすべて指定し、タイトルの番号付けを自分で指定しなければなりません。

属性:

GetAccess
public
SetAccess
public

この節に番号を付けるための選択。logical の 1 (true) または 0 (false) として指定します。指定内容は以下のとおりです。

  • 1 (true) — 節はレポート内の他の節に対して相対的に番号付けされます。セクション番号は、セクション タイトルに表示されます。

  • 0 (false) — 節は番号付けされません。

この Numbered プロパティの値は、mlreportgen.report.Section.number メソッドによってレポートのすべての節に対して指定された番号付けをオーバーライドします。

属性:

GetAccess
public
SetAccess
public

データ型: logical

セクションのコンテンツ。次のいずれかの値として指定します。

  • string または文字ベクトル

  • DOM ドキュメント パーツに追加できる DOM オブジェクト

  • string または文字ベクトルから成る 1 行 N 列または N 行 1 列の配列

  • string スカラー、文字配列、および DOM オブジェクトからなる 1xN または Nx1 の cell 配列

  • レポーター (Section レポーターを含む)

Section コンストラクターまたは add メソッドを使用して、このプロパティを設定します。直接設定することはできません。

属性:

GetAccess
public
SetAccess
public

このレポーターのテンプレートのソース。次のいずれかの方法で指定します。

  • このレポーターのテンプレートを含むファイルのパスを指定する文字ベクトルまたは string スカラー

  • このレポーターが使用するテンプレートを含む、またはこのレポーターのテンプレートをテンプレート ライブラリに含む、レポーターまたはレポート

  • このレポーターが使用するテンプレートを含む、またはこのレポーターのテンプレートをテンプレート ライブラリに含む、ドキュメント オブジェクト モデル (DOM) ドキュメントまたはドキュメント パーツ

指定するテンプレートは、このレポーターを追加するレポートと同じタイプでなければなりません。たとえば、Microsoft® Word レポートでは、TemplateSrc は Word レポーター テンプレートでなければなりません。TemplateSrc プロパティが空の場合、このレポーターはレポートの出力タイプに既定のレポーター テンプレートを使用します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true
Dependent
true

このレポーターのテンプレートの名前。文字ベクトルまたは string スカラーとして指定します。このレポーターのテンプレートは、このレポーターの TemplateSrc プロパティで指定されたテンプレートのテンプレート ライブラリになければなりません。

属性:

GetAccess
public
SetAccess
public

データ型: char | string

このレポーターのハイパーリンク ターゲット。リンク ターゲット ID を指定する文字ベクトルもしくは string スカラー、または mlreportgen.dom.LinkTarget オブジェクトとして指定します。文字ベクトルまたは string スカラー値は LinkTarget オブジェクトに変換されます。リンク ターゲットは、出力レポートでこのレポーターのコンテンツの直前にあります。

属性:

GetAccess
public
SetAccess
public

メソッド

すべて展開する

例

すべて折りたたむ

ライブ スクリプトを開く

章に節を追加し、レポートに章を追加します。章のレイアウト方向を横向きに設定します。 

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

theReport = Report("SectionExampleReport","pdf");

append(theReport,TitlePage(Title="Report with Sections"));

append(theReport,TableOfContents);
 
theChapter = Chapter("Images");
append(theChapter,Section(Title="Boeing 747",Content=Image("BoeingSectionExample.jpg")));
append(theChapter,Section(Title="Peppers",Content=Image("PeppersSectionExample.png")));
append(theReport,theChapter);

close(theReport);
rptview(theReport);

生成されたレポートのイメージを含むセクションは次のようになります。

  • この例では、DOM Text オブジェクトを使用してタイトルを定義します。DOM オブジェクトを使用することで、そのプロパティを設定し、セクション タイトルの既定色である黒をオーバーライドできます。

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

rpt = Report("New Report","pdf");
open(rpt)
sect = Section;
sect.Title = Text("A Section");
sect.Title.Color = "blue";
append(rpt,sect);

close(rpt)
rptview(rpt)

    Example of title defined as "A Section" in displaying in blue

ライブ スクリプトを開く

HTML レポートを作成し、節のタイトルを中央揃えに設定します。

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

rpt = Report('My Report','html');
append(rpt,TitlePage(Title='My Report'));
append(rpt,TableOfContents);
chTitle = Heading1('Chapter ');
chTitle.Style = {CounterInc('sect1'),...
     WhiteSpace('preserve')...
     Color('black'),...
     Bold, FontSize('24pt')};
append(chTitle,AutoNumber('sect1'));
append(chTitle,'. ');

sectTitle = Heading2();
sectTitle.Style = {CounterInc('sect2'),...
     WhiteSpace('preserve') ...
     HAlign('center'),PageBreakBefore};
append(sectTitle,AutoNumber('sect1'));
append(sectTitle,'.');
append(sectTitle,AutoNumber('sect2'));
append(sectTitle,'. ');
title = clone(chTitle);
append(title,'Images');
ch = Chapter(Title=title);
title = clone(sectTitle());
append(title,'Boeing 747');
append(ch,Section(Title=title,Content=Image(which('b747.jpg'))));
title = clone(sectTitle());
append(title,'Peppers');
append(ch,Section(Title=title,Content=Image(which('peppers.png'))));

append(rpt,ch);
close(rpt);
rptview(rpt);

section_rptr_ex_3.png

バージョン履歴

R2017b で導入

参考

|

トピック