TableOfContentsコントロールは、見出しマップをレポートのボディに表示するために使用します。見出しマップは、レポートの見出しレベル、およびラベルとそのページ番号の階層であり、これにより、データ構成がすぐにわかり、目的のデータにすばやく移動することができます。
TableOfContentsコントロールを使用して、印刷と表示のために目次構造をレポートのボディに埋め込むことができます。
TableOfContentsで使用することができる主なプロパティを説明します。すべてのプロパティを表示するには、プロパティモードを[詳細プロパティを表示]にする必要があります。
幅: 罫線の太さに設定する値をポイント単位で入力します。
スタイル: 罫線のスタイルを選択します。
色: カラーピッカー、標準色、またはWebカラーにより、罫線の色を選択します。
スタイル: 利用可能なスタイルのリストから選択し、コントロールに適用するように設定します。
改ページ: 改ページ設定を選択します。RDLレポートのみ有効です。
デザイン面上のTableOfContentsコントロールを選択し「項目の追加」を選択することで、新しいレベルを追加できます。レベルで使用できる主なプロパティを説明します。
色: カラーピッカー、標準色、またはWebカラーにより、線の色を選択します。
スタイル: テキストにフォントスタイルを適用します。TableOfContentsの[レイアウト]>[スタイル]でテーマを選択した場合、テキストは選択したテーマに従って表示されることに注意してください。次のスタイルを選択できます。
文字飾り: 線を使用してテキストを装飾できます。以下のオプションを選択できます。
充填文字: 式を使用して充填文字を入力します。
充填文字の表示: 充填文字を表示するかどうかを設定します。
ページ番号の表示: ページ番号を表示するかどうかを設定します。
次の例では、公開年、レイティング、上映時間などの映画情報とともに映画を一覧表示する映画カタログ、および特定のジャンルに移動できるように目次リストを表示するレポートを作成する方法を示します。
まず、レポートを作成します。このレポートでは、2つのListデータ領域、および映画の[公開年]、[MPAAの評価]、[レイティング]、[上映時間]を表示するいくつかのTextBoxコントロールを使用しています。また、ジャンルとタイトルで映画をグループ化するためにListデータ領域で式を使用しています。レポートのレイアウトは次のようになります。
設計時 | 実行時 |
---|---|
![]() |
![]() |
RDLレポートを作成し、Listデータ領域(List1)をドラッグして、レポートのデザイナ面上にドロップします。
[グループ]セクションの[式]プロパティに「=Fields!GenreName.Value
」の式を入力します。
TextBoxコントロールをListデータ領域にドラッグ&ドロップし、[GenreName]フィールドにバインドします。これはカタログのヘッダになります。
別のListデータ領域(List2)をドラッグして、List1にドロップします。
[グループ]セクションの[式]プロパティに「=Fields!Title.Value
」の式を入力します。
TextBoxコントロールをListデータ領域にドラッグ&ドロップし、[Title]フィールドにバインドします。これは映画の各エントリのヘッダになります。
次に、List2の[Title]の下にいくつかのTextBoxコントロールをドラッグ&ドロップし、それぞれの[値]プロパティを次のように設定します。
コントロール名 | 設定値 |
---|---|
TextBox3 | ="公開年: " & Fields!YearReleased.Value & ", " & Fields!Country.Value |
TextBox4 | ="MPAA の評価: " & Fields!MPAA.Value |
TextBox5 | レイティング: |
TextBox6 | =Fields!UserRating.Value |
TextBox7 | ="上映時間: " & Fields!Length.Value & " min" |
レポートにタイトルを追加するには、TextBoxコントロールをレポート上にドラッグ&ドロップし、[値]プロパティを「映画カタログ」に設定します。
レポートに配置する各コントロールのサイズや位置を調整して、レポートの外観をカスタマイズします。
レポートをプレビューします。
次に、TableOfContentsコントロールを追加して、レポートまたは見出しマップを表示します。
TextBoxコントロールの[見出しレベル]プロパティを使用して、レポートの階層構造を定義できます。例えば、1つのTextBoxを見出しレベル1に設定し、グループヘッダを表示する別のTextBoxを見出しレベル2に設定すると、見出しレベル1エントリの下に見出しレベル2のすべてのエントリがまとめられます。見出しは自動連番で表示されます。
レポートのタイトルの下に、TableOfContentsコントロールをドラッグ&ドロップし、そのサイズを調整します。
TableofContentsコントロールでLevel1(GenreNameを表示する)を選択し、プロパティを次のように設定します。
プロパティ名 | 設定値 |
---|---|
テキスト > 色 | #0096aa |
サイズ | 14pt |
充填文字 | 破線(-) |
充填文字の表示 | はい |
[+ 項目の追加]をクリックして、Level2(タイトルを表示する)を追加し、プロパティを次のように設定します。
プロパティ名 | 設定値 |
---|---|
サイズ | 10pt |
Padding | 5 pt(左) |
充填文字 | 点線(-) |
充填文字の表示 | はい |
[エクスプローラ]をクリックし、レポートを選択します。[見出しマップ]セクションのプロパティを次のように設定します。
プロパティ名 | 設定値 |
---|---|
レベル.0 | A,B,C,D,E |
レベル.1 | 1,2,3,4,5 |
ソース | Headings |
[GenreName]テキストボックスを選択し、[見出しレベル]プロパティを「1」に設定します。
レポートをプレビューします。
レポートに含まれるコントロールの[ラベル]プロパティを設定することで、コントロール間の親子関係に基づく階層構造を見出しマップで示すことができます。たとえば、Listデータ領域のラベルプロパティを設定してから、Listデータ領域内にTextBoxコントロールを配置したとします。見出しマップを表示すると、TextBoxのラベルがListデータ領域のラベル内に入れ子になって表示されるため、表示が階層的になります。
レポートのタイトルの下に、TableOfContentsコントロールをドラッグ&ドロップし、そのサイズを調整します。
TableOfContentsコントロールの各Levelのプロパティを設定するには、上記のセクションの手順2と3を参照してください。
[エクスプローラ]をクリックし、レポートを選択します。[見出しマップ]セクションの[ソース]プロパティを「Labels」に設定します。
List1データ領域を選択し、[見出しマップラベル]プロパティを「=Fields!GenreName.Value
」に設定します。これは、TableofContentsコントロールのLevel1になります。
メモ: ラベルを使用してマップされた目次は自動連番で表示されません。目次に番号を追加するには、Listデータ領域の[ラベル]プロパティにDocumentMap.Pathの式を使用する必要があります。たとえば、最初のレベル(GenreName)に番号を追加するには、List1データ領域を選択し、[ラベル]プロパティを「
=DocumentMap.Path & ". " & Fields!GenreName.Value
」に設定します。
また、List2データ領域を選択し、[見出しマップラベル]プロパティを「=Fields!Title.Value
」に設定します。これは、TableofContentsコントロールのLevel2になります。
レポートをプレビューします。