段落間の間隔の指定

ライブスクリプトを開く

これらの例では、ドキュメント内の DOM Paragraph オブジェクト間の間隔を指定する方法を示します。間隔を設定するには、Paragraph オブジェクトの Style プロパティを変更するか、ドキュメントテンプレートで段落スタイルを作成します。

プログラムによるスタイルの設定

この例では、各段落の Style プロパティに OuterMargin オブジェクトを含めることによって、段落の間隔をプログラムで設定します。次の出力が作成されます。

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

import mlreportgen.dom.*

ドキュメントを作成して開きます。Word ドキュメントを作成するには、出力タイプを "pdf" から "docx" に変更します。HTML ドキュメントを作成するには、"pdf" を、複数ファイルドキュメントの場合は "html" に、単一ファイルドキュメントの場合は "html-file" にそれぞれ変更します。例を説明するための見出しを追加します。

d = Document("myDoc1", "pdf");
open(d);

append(d, Heading1("Spacing Using OuterMargin"));

段落を作成し、OuterMargin オブジェクトを含むようにその Style を設定します。左、右、および上の外側余白を 0 ポイントに設定し、下余白を 50 ポイントに設定します。段落をドキュメントに追加します。

p1 = Paragraph(...
    "This is a paragraph with a bottom outer margin of 50pt.");
p1.Style = {OuterMargin("0pt", "0pt","0pt","50pt")};

append(d, p1);

下余白が異なる 2 つの段落をさらに作成します。最後の text オブジェクトと共に段落をドキュメントに追加して、すぐ前の段落の下余白を確認できるようにします。

p2 = Paragraph(...
    "This is a paragraph with a bottom outer margin of 25pt.");
p2.Style = {OuterMargin("0pt", "0pt","0pt","25pt")};
append(d, p2);

p3 = Paragraph(...
    "This is a paragraph with a bottom outer margin of 5pt.");
p3.Style = {OuterMargin("0pt", "0pt","0pt","5pt")};
append(d, p3);

append(d, Text("Text to show spacing"));

ドキュメントを閉じて表示します。

close(d);
rptview(d);

テンプレートでのスタイルの使用

この例では、段落は、ドキュメントで使用されるカスタムテンプレートファイルで定義されたスタイルを使用します。次の出力が作成されます。

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

import mlreportgen.dom.*

PDF ドキュメントを作成して開きます。Document オブジェクトを作成するときに、example_template という名前のカスタムドキュメントテンプレートを指定します。Word または HTML のドキュメントを作成するには、まず Word または HTML のテンプレートを作成します。次に、作成したテンプレートに応じて、"pdf" を、"docx"、"html"、または "html-file" に変更します。

テンプレートの作成方法の詳細については、HTML および PDF のテンプレートの作成またはMicrosoft Word テンプレートの作成を参照してください。

d = Document("myDoc2", "pdf", "example_template");

カスタム PDF テンプレート example_template は、次のように、example_template\stylesheets\root.css で定義された exampleParagraphStyle という名前の段落スタイルを含むように変更済みです。

前の例と同様に、margin-bottom 値によって、段落の下余白が 50 ポイントに設定されます。あるいは、テンプレートの既定の段落スタイルを変更して、ドキュメントの段落が自動的にカスタムスタイルをもつようにすることもできます。example_template の既定の段落スタイルは、次のように、25 ポイントの下余白をもつように変更されています。

ドキュメントを開き、例を説明するための見出しを追加します。

open(d);

append(d, Heading1("Spacing Using Template-defined Paragraph Styles"));

exampleParagraphStyle をスタイル名として使用して段落を作成します。スタイル名を指定せずに別の段落を作成し、テンプレートの既定の段落スタイルを使用するようにします。

p1 = Paragraph("This is a paragraph with" + ...
    " a custom style defined in a template.", ...
    "exampleParagraphStyle");

p2 = Paragraph("This is a paragraph with the" + ...
    "default style defined in a template.");

既定の段落スタイルで別の段落を作成しますが、異なる下余白をもつように Style プロパティを設定します。これにより、テンプレートの既定のスタイルがオーバーライドされます。

p3 = Paragraph(...
    "This is a paragraph with a bottom outer margin of 5pt.");
p3.Style = {OuterMargin("0pt", "0pt","0pt","5pt")};

最後の text オブジェクトと共に段落をドキュメントに追加して、すぐ前の段落の下余白を確認できるようにします。

append(d, p1);
append(d, p2);
append(d, p3);
append(d, Text("Text to show spacing."));

ドキュメントを閉じて表示します。

close(d);
rptview(d);