Main Content

mlreportgen.dom.LOC クラス

名前空間: mlreportgen.dom

表題のリスト

R2020b 以降

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

説明

mlreportgen.dom.LOC クラスのオブジェクトを使用して、表題付きレポート要素のリストを生成します。表題付きの図やタイトル付きのテーブルのリストを生成するには、mlreportgen.dom.LOF クラスと mlreportgen.dom.LOT クラスのオブジェクトをそれぞれ使用します。数式など、他のタイプのレポート要素のリストを生成するには、LOC オブジェクトを使用します。

各リスト項目には、レポート要素の表題と、レポート内の表題へのリンクが含まれます。PDF または Microsoft® Word のレポートでは、ページ番号および表題とページ番号の間のスペースを埋めるリーダーもリスト項目に含まれます。

PDF および Word レポートでは、レポート生成プログラムで指定した場所に表題のリストが配置されます。HTML レポートでは、表題のリストはサイド パネルに配置され、List of とそれに続く AutoNumberStreamName プロパティの値 (最初の文字が大文字になる) で構成されるタイトルをもちます。

リストにレポート要素を含めるには、次のようにします。

  1. equation などの番号付けストリーム名を選択します。LOC オブジェクトの AutoNumberStreamName プロパティを番号付けストリームの名前に設定します。

  2. mlreportgen.dom.Paragraph オブジェクトを使用して、レポート要素の表題またはタイトルを作成します。

  3. mlreportgen.dom.AutoNumber オブジェクトを使用して、Paragraph オブジェクトを番号付けストリーム名に関連付けます。

リストの生成方法は、レポートのタイプによって異なります。

  • PDF — DOM API がレポート生成時にリストを生成します。

  • Word — DOM API がリストのプレースホルダーを生成します。リスト項目を生成するには、レポート生成プログラムまたは Word で Word ドキュメントを更新しなければなりません。Word ドキュメントの目次および生成されたリストの更新を参照してください。

  • HTML — DOM API がリストのプレースホルダーを生成します。レポートが HTML ブラウザーで開かれるときに、ブラウザーによってリストが生成されます。

メモ

レポート要素に続く表題またはレポート要素に先行するタイトルに LOC オブジェクトを使用できます。

mlreportgen.dom.LOC クラスは handle クラスです。

クラス属性

ConstructOnLoad
true
HandleCompatible
true

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

作成

説明

例

LOCObj = mlreportgen.dom.LOC() は mlreportgen.dom.LOC オブジェクトを作成し、LeaderPattern プロパティを '.' に設定します。

LOCObj = mlreportgen.dom.LOC(leaderPattern) は mlreportgen.dom.LOC オブジェクトを作成し、LeaderPattern プロパティを指定されたリーダー パターンに設定します。

プロパティ

すべて展開する

番号付けストリームの名前。文字ベクトルまたは string スカラーとして指定します。

表題とページ番号の間に使用するリーダーのタイプ。次の文字ベクトルまたは string スカラーのいずれかとして指定します。

  • '.' または 'dots'

  • ' ' または 'space'

このプロパティは、PDF レポートにのみ適用されます。Word レポートには常にドット リーダーがあります。HTML レポートにはリーダーがありません。

スタイル名。文字ベクトルまたは string スカラーとして指定します。スタイル名は、この要素を追加するドキュメントまたはドキュメント パーツのスタイル シートで指定したスタイルの名前です。指定されたスタイルは、この要素の Style プロパティで指定された書式によってオーバーライドされない限り、出力ドキュメントでのこの要素の外観を定義します。スタイル シートの使用の詳細については、スタイル シートのスタイルの使用を参照してください。

メモ

Microsoft Word 出力ではスタイル名が無視されます。

属性:

NonCopyable
true

データ型: char | string

このドキュメント要素オブジェクトの書式指定。書式オブジェクトの配列として指定します。このプロパティで指定された書式は、この要素の StyleName プロパティで指定された対応する書式をオーバーライドします。この要素に適用されない書式は無視されます。

属性:

NonCopyable
true

データ型: cell

このドキュメント要素のカスタム属性。mlreportgen.dom.CustomAttribute オブジェクトの配列として指定します。カスタム属性は、このオブジェクトが追加されるドキュメント要素の出力形式でサポートされていなければなりません。

属性:

NonCopyable
true

mlreportgen.dom.LOC オブジェクトの親。ドキュメント要素オブジェクトとして指定します。ドキュメント要素の親は 1 つでなければなりません。

属性:

SetAccess
private
NonCopyable
true

mlreportgen.dom.LOC オブジェクトの子。ドキュメント要素オブジェクトの配列として指定します。このプロパティには、append メソッドを使用して追加されたドキュメント要素オブジェクトが含まれます。

属性:

SetAccess
private
NonCopyable
true

mlreportgen.dom.LOC オブジェクトのタグ。文字ベクトルまたは string スカラーとして指定します。DOM API は、このオブジェクトを作成するときに、セッション固有タグを生成します。生成されるタグの形式は CLASS:ID という形式です。ここで、CLASS はオブジェクト クラスです。ID はオブジェクトの Id プロパティの値です。独自のタグ値を指定すると、ドキュメント生成中に問題が発生したときにどこを確認すればよいかを特定しやすくなります。

属性:

NonCopyable
true

データ型: char | string

mlreportgen.dom.LOC オブジェクトのオブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。DOM API は、ドキュメント要素オブジェクトの作成時にセッション固有識別子を生成します。Id には独自の値を指定できます。

属性:

NonCopyable
true

データ型: char | string

メソッド

すべて展開する

例

すべて折りたたむ

ライブ スクリプトを開く

この例では、レポートでコード例の表題リストを生成します。同じ手順を使用して、他のレポート要素の表題リストを生成できます。この例では、example という名前の自動番号付けストリームに表題を関連付けることで、リストに含める表題を識別します。番号付けストリームには任意の名前を使用できますが、その名前は、表題のリストを表す mlreportgen.dom.LOC オブジェクトの AutoNumberStream プロパティの値と一致していなければなりません。

長い完全修飾クラス名を使用せずに済むよう、DOM API 名前空間をインポートします。

import mlreportgen.dom.*

レポートを作成します。

d = Document("DOM Report with List of Captions","pdf");

表題のプレースホルダーのリストを作成し、レポートに追加します。

locObj = LOC();
locObj.AutoNumberStreamName = "example";
append(d,locObj);
append(d,PageBreak);

コード例を含む段落を作成します。

pr1 = Preformatted("  a = 1;" + newline + "  b = 2;" + newline + "  c = a + b;");
append(d,pr1);

コード例の表題の段落を作成します。

p1 = Paragraph("Example ");

example という名前の自動番号付けストリームを作成し、それを段落に関連付けます。

append(p1,AutoNumber("example"));

番号付けストリームのカウンターをインクリメントします。

p1.Style = {CounterInc("example"),WhiteSpace("preserve")};

残りの表題テキストを段落に追加し、その段落をレポートに追加します。

append(p1,".");
append(p1," Addition");
append(d,p1);

コード例とコード例の表題を含む別の段落を作成します。example 番号付けストリームを表題に関連付け、番号付けカウンターをインクリメントします。 

pr2 = Preformatted("  a = 1;" + newline + "  b = 2;" + newline + "  c = a * b;");
append(d,pr2);
p2 = Paragraph("Example ");
append(p2,AutoNumber("example"));
p2.Style = {CounterInc("example"),WhiteSpace("preserve")};

残りの表題テキストを段落に追加し、その段落をレポートに追加します。

append(p2,".");
append(p2," Multiplication");
append(d,p2);

レポートを閉じて表示します。

close(d);
rptview(d);

生成されたレポートで、表題リストは次のようになります。

バージョン履歴

R2020b で導入

参考

| | | | | |

トピック