ヘッダーとフッターのスタイル シート セル
スタイル シート セルとセル グループについて
"スタイル シート セル" を使用して、PDF レポートのヘッダーとフッターのコンテンツを指定します。
MATLAB® Report Generator™ ソフトウェアは、1 つのページを 6 つの "セル" として定義します。これらのセルは、ページのヘッダーの左側、右側、中央と、ページのフッターの左側、右側、中央に対応します。
"セル グループ" は、1 つ以上のスタイル シート セルで構成されます。PDF レポートには、次の 2 つのセル グループを使用できます: [Header Content] および [Footer Content]。
セル グループにおける各セルのプロパティ ペインは、グループの現在のスタイル シート セルの定義をリストします。これらの定義は、[条件付きセルの値] の 2 列のリストに表示されます。最初の列には "条件" の名前が表示されます。2 番目の列には指定された条件が満たされた場合にレポートに表示される "コンテンツ" が表示されます。
たとえば、スタイル シート セル Page sequence - Blank
は空白のページのコンテンツを指定します。既定では、コンテンツは空です。同様に、Position - Right
はすべてのページにおけるヘッダーの右側のコンテンツを指定します。
条件と値のさまざまな組み合わせを使用して、ヘッダーとフッターのコンテンツをカスタマイズできます。MATLAB Report Generator ソフトウェアは、よく使用される事前定義済みの条件をいくつか提供します。これらの事前定義済みのセルは、Header Content セル グループと Footer Content セル グループのプロパティ ペインに表示されます。
ヘッダーとフッター
指定された条件を満たすコンテンツの追加
スタイル シート セルのプロパティ ペインを使用して、指定された条件を満たすコンテンツを指定できます。スタイル シート セルのプロパティ ペインは、次を含みます。
ラベル | 定義 | 説明 |
---|---|---|
条件 | コンテンツがレポートに表示されるために満たされなければならない条件 | これは、よく使用される定義済みの条件の選択リストです。条件を選択して [編集] をクリックし、条件の XML コードを確認または変更します。 |
値 (XML) | 条件が満たされるとレポートに表示されるコンテンツ | ヘッダーまたはフッターのコンテンツの XML コードを変更または作成します。 |
テンプレートの追加 | コンテンツの追加に使用するテンプレートの名前 | コンテンツの追加に使用できる XML コードを含むテンプレートです。詳細については、テンプレートによりヘッダーとフッターにコンテンツを追加を参照してください。 |
ファイル コンバーターは、ページを処理する際に、ページ上の 6 つのセルのそれぞれに関連する設定を評価し、それに応じてコンテンツを追加します。特定のセルに有効な条件が存在しない場合、ファイル コンバーターはセル グループに既定の値を使用します。
使用可能な条件と XML にコード化されたそれらの値を、次の表に示します。
条件名 | 条件に使用可能な値 | サンプル XML コード |
---|---|---|
$position | right center left | $position='right' $position='center' $position='left' |
$sequence | odd even first blank | $sequence=odd $sequence=even $sequence=first $sequence=blank |
$double-sided | 0 1 | $double-sided=0 $double-sided=1 |
$pageclass | $titlepage $lot $body | $pageclass=$titlepage $pageclass=$lot $pageclass=$body |
標準的な論理演算子 (=
、!=
、and
、or
など) と入れ子にされた式 (式の内部に含まれる式で、文字の並びをかっこで囲んで表す) を使用して、"複雑な条件" を指定します。複雑な条件を使用してページのヘッダーとフッターの位置を設定できます。また、それらを使用して、レポートでコンテンツが表示される位置など、他の設定を指定することもできます。
テンプレートによりヘッダーとフッターにコンテンツを追加
"テンプレート" は、ヘッダーとフッターに以下の項目を追加するために使用できます。
テキスト
作成者名
ページ番号
章および節のタイトル
章番号
ドラフト情報
コメント
グラフィックス
ファイル コンバーターが使用するテンプレートは、Extensible Style Language Transformations (XSLT) です。これは、XML ドキュメントを他の XML ドキュメントに変換するための言語です。XSLT の詳細については、World Wide Web Consortium (W3C®) の Web サイト https://www.w3.org/TR/xslt
を参照してください。
テンプレートを使用してヘッダーまたはフッターのコンテンツを指定するには、以下のようにします。
[テンプレートの追加] リストで、追加するコンテンツのタイプを選択します。
[追加] をクリックします。
右側のプロパティ ペインに、選択したタイプに対する既定のコンテンツが表示されます。既定のコンテンツを変更するには、XML コードを編集します。
たとえば、コンテンツとして text
を指定する方法は以下です。
[テンプレートの追加] リストで [テキスト] を選択します。
[追加] をクリックします。
xsl:text
の既定値はConfidential
です。必要に応じて値を編集します。
グラフィックス ファイルの挿入
レポートのヘッダーまたはフッターにグラフィックス ファイルを追加するには、以下が必要です。
[Header Content] または [Footer Content] スタイル シート セル内でファイルの名前を指定します。
データ項目
Region Before Extent
とRegion After Extent
の値を編集します。これらは、PDF 書式設定のオプション ペインの [Pagination and General Styles] フォルダーにあります。
ヘッダーへのグラフィックス ファイルの追加の例については、Add Graphics to Headers in PDF Reportsを参照してください。
メモ
PDF レポートでは、ヘッダーとフッターにおいてビットマップ (.bmp
) イメージ、jpeg (.jpg
) イメージおよび Scalable Vector Graphics (.svg
) イメージのみをサポートしています。
フォントとその他のプロパティの変更
スタイル シート セルを使用してヘッダーとフッターのフォント ファミリなどのプロパティを変更することはできません。ヘッダーとフッターのコンテンツのスタイルを指定するには、属性の設定 [Header Content Properties] と [Footer Content Properties] を使用します。
これらの属性の設定は、いずれも PDF スタイル シートのページ編集スタイル データ項目です。左側のアウトライン ペインで設定の特定の属性を選択することで、その属性を編集できます。
PDF レポートのフォント サイズやその他のプロパティを変更する例については、Change Font Size, Page Orientation, and Paper Type of a Generated Reportを参照してください。