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

mlreportgen.report.ReportLayout クラス

名前空間: mlreportgen.report

レポートのページ レイアウト

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

説明

mlreportgen.report.ReportLayout クラスのオブジェクトを使用して、透かし、先頭ページの番号付け、ページ番号形式、ページのサイズと方向、余白などのレポート ページ レイアウト オプションを指定します。

メモ

レポートは、このクラスのインスタンスを作成し、それを mlreportgen.report.Report の Layout プロパティに割り当てます。自分でオブジェクトを作成することはしません。

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

クラス属性

HandleCompatible
true

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

プロパティ

すべて展開する

透かしイメージ。[] として指定するか、イメージ パス名を含む文字ベクトルまたは string スカラーとして指定します。このプロパティは、レポートを開く前に設定しなければなりません。透かしはレポートのすべてのページに表示されます。レポート セクションおよびレポートのレイアウト オブジェクトの Watermark プロパティが [] の場合、透かしは表示されません。

有効なイメージの種類は次のとおりです。

  • .emf

  • .gif

  • .jpg

  • .pdf

  • .png

  • .svg

  • .tiff

メモ

透かしを追加できるのは、PDF レポートのみです。他のレポート タイプでは、このプロパティの内容は無視されます。

属性:

GetAccess
public
SetAccess
public

データ型: char | string

レポートの各セクションの先頭ページで使用する番号。[] または正の整数として指定します。たとえば、レポートの先頭ページ番号を 4 に設定すると、レポートの各章の先頭ページ番号は 4 になります。個々のセクションで異なる先頭ページ番号を使用するには、セクション レポーターで使用される mlreportgen.report.ReporterLayout オブジェクトの FirstPageNumber プロパティを設定します。レポートの既定の番号付けは [] で、これは第 1 章の先頭ページがページ 1 であることを示します。レポートの後続のすべてのページには、順番に番号が付けられます。

属性:

GetAccess
public
SetAccess
public

データ型: int32

レポートに使用するページの番号付けのタイプ。文字ベクトルまたは string スカラーとして指定します。指定したページ番号形式がレポートのすべてのページに表示されます。章などの個々のセクションで異なるページ番号形式を使用するには、セクション レポーターで使用される mlreportgen.report.ReporterLayout オブジェクトの PageNumberFormat プロパティを設定します。有効なページ番号形式のリストについては、mlreportgen.dom.PageNumber の Format プロパティを参照してください。

属性:

GetAccess
public
SetAccess
public

データ型: char | string

レポートのページの方向。true または false として指定します。縦向きを横向きに変更するにはこのプロパティを true に、横向きを縦向きに変更するには false に設定します。値が [] の場合、方向はレポート レイアウトで指定されたページ サイズによって決定されます。

属性:

GetAccess
public
SetAccess
public

データ型: logical

レイアウトのページ サイズ。mlreportgen.dom.PageSize オブジェクトとして指定します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

このレイアウトのページ余白、ヘッダー、フッター、およびとじしろのサイズ。mlreportgen.dom.PageMargins オブジェクトとして指定します。

属性:

GetAccess
public
SetAccess
public

レイアウトのページ境界線。mlreportgen.dom.PageBorder オブジェクトとして指定します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

例

すべて折りたたむ

ライブ スクリプトを開く

レポート全体のページ番号形式をアラビア数字に設定し、目次のページ番号をローマ数字に設定します。各章は、レポート全体の既定の形式であるアラビア数字形式を使用します。最初の章の先頭ページの既定値は 1 です。

import mlreportgen.report.*
rpt = Report('newreport'); 
rpt.Layout.PageNumberFormat = 'n';

tp = TitlePage();
tp.Title = 'New Report'; 
tp.Author = 'MathWorks'; 
append(rpt,tp);

toc = TableOfContents();
toc.Layout.PageNumberFormat = 'i';
append(rpt,toc);

ch = Chapter();
ch.Title = 'Introduction';
sec = Section('First Section of Chapter 1');
txt = ['This is the first section of chapter 1. ',...
      'The page number format is Arabic numbers, ',...
      'which is the default for the report.'];
append(sec,txt);
append(ch,sec);
append(rpt,ch); 

ch = Chapter(); 
ch.Title = '2nd chapter';
sec = Section('First Section of Chapter 2'); 
txt = ['This is the first section of chapter 2. ',...
      'The page number format is Arabic numbers, ',...
      'which is the format defined for the report.'];
append(sec,txt);
append(ch,sec);
append(rpt,ch);

close(rpt);
rptview(rpt);

バージョン履歴

R2017b で導入

すべて展開する

参考

| | | | | |

トピック