PowerTools ActiveReports for .NET 9.0J > ActiveReportsユーザーガイド > 概念 > ページレポート/RDLレポートの概念 > ページレポート/RDLレポートのレポートコントロール > BandedList |
BandedListデータ領域は自由な形式のバンドのコレクションです。BandedListはデフォルトとして[Header]、[Footer]と[Details]の3つのバンドから構成されています。[Details]バンドはデータのレコード件数分繰り返し出力され、[Header]と[Footer]はBandListの最初と最後に出力されます。
BandedListで使用できる主なプロパティを以下に説明します。
BandedListのプロパティ
プロパティ | 解説 |
---|---|
DataSetName | BandedListに出力するデータセットを指定します。 |
KeepTogether | Trueの場合、BandedListの途中で改ページを行いません。BandedListが複数ページにまたがる場合は、出力前に改ページされます。 |
OverflowName | データ領域に収まらない(オーバーフローする)データを出力するOverflowPlaceHolderコントロールの名前を指定します。 |
バンドのプロパティ
プロパティ | 解説 |
---|---|
CanGrow | Trueの場合、出力するデータに合わせてバンドの高さを拡大します。 |
CanShrink | Trueの場合、出力するデータに合わせてバンドの高さを縮小します。 |
KeepTogether | Trueの場合、バンドの途中で改ページを行いません。バンドが複数ページにまたがる場合は、出力前に改ページされます。 |
PageBreakAtEnd | Trueの場合、バンドの出力後に改ページを行います。 |
PageBreakAtStart | Trueの場合、バンドの出力前に改ページを行います。 |
RepeatOnNewPage | HeaderまたはFooter専用のプロパティです。Trueの場合、BandedListが複数ページにまたがる場合に、各ページにHeaderまたはFooterを出力します。 |
BandedListでは、グループヘッダとグループフッタバンドも追加できます。このバンド内に配置するレポートコントロールはグループインスタンスごとに表示し、またグループをネストすることも可能です。RDLレポートでは、ヘッダやフッタのバンドに他のデータ領域をネストすることができます。BandedListでグルーピングする処理はTableデータ領域の場合と同様です。各グループのグルーピング式を設定でき、グループをソートすることも可能です。
注意 : BandedList自体にデータのソート機能は用意されていません。ソート処理はクエリの段階で行う必要があります。 |
BandedListデータ領域のプロパティは[プロパティ設定ダイアログ]から設定できます。このダイアログを表示するには、デザイナ上のBandedListを選択した状態で、[プロパティ]ウインドウ内にある[プロパティ設定ダイアログ]のリンクをクリックします。
[BandedList]ダイアログで設定する内容を、タブページごとに説明します。
メモ : これらのプロパティの多くに用意されている<式...>オプションをクリックすると、[式エディタ]ダイアログが表示されます。このダイアログでは、値を判定するため式を作成することができます。 |
[全般]
[名前] : レポートに使用されていないユニークなBandedListの名前を入力します。
[ツールヒント] : 実行時にユーザーがBandedList上をホバーした時に表示させたい値または式を入力します。
[データセット名] : BandedListに関連付けるデータセットを選択します。コンボボックスには、レポートのデータセットコレクションにあるすべてのデータセットが表示されます。
[ヘッダ/フッタ] : 以下の任意オプションを選択します。
[表示]
デフォルト設定では、レポートの実行時にBandedListは表示されますが、BandedListを非表示にしたり、ある条件を満たした場合のみ非表示にしたり、または別のレポートアイテムでの表示の切り替えなどが実現できます。
[レポートの初期実行時]
[次のレポートアイテムでの表示の切り替えを可能にする] : 他のレポートアイテムにトグルを表示するには、このチェックボックスをオンにします。ドロップダウンが有効になり、BandedListの表示を切り替えるためのTextBoxコントロールを指定します。ユーザーがトグルをクリックして、BandedListを表示または非表示にできます。
[ナビゲーション]
[見出しマップラベル] : 目次(見出しマップ)でこのアイテムを表すためのラベルとして使用する式を入力します。
[ブックマークID] : BandedListデータ領域の位置を示すIDを入力します。[ブックマークに移動]アクションと組み合わせて使用することにより、別のレポートコントロールからこの項目にリンクできます。
[グループ]
(+)ボタンをクリックしてBandedListに新しいグループを追加し、(×)ボタンを使用して削除できます。1つ、または複数のグループを追加した後、矢印ボタンを使用して順序を変更することができます。次のタブで各グループの情報を設定できます。
[全般]
[名前] : レポートに使用されていないユニークなグループの名前を入力します。このプロパティは、[グループ化の条件]の[式]が設定されるまで設定することができません。
[グループ化の条件] : データをグループ化するために使用する式を入力します。
[見出しマップラベル] : 目次(見出しマップ)でこのアイテムを表すためのラベルとして使用する式を入力します。
[親グループ] : 再帰階層の場合使用します。親グループとして使用する式を入力します。
[フィルタ]
コレクションに新しいフィルタを追加するには、次の3つの値を設定する必要があります。
式: フィルタリングに使用する式を入力します。
演算子 : フィルタリングの方法を次の演算子から選択します。
値 : 選択された演算子に基づいて左側の式と比較する値を入力します。Between演算子を選択した場合、2つの値ボックスが有効になります。In演算子を選択した場合、多くの値を入力することができます。
[並べ替え]
(+)ボタンをクリックして並べ替えの新しい式を入力し、(×)ボタンを使用して削除します。
[式] : グループ内のデータを並べ替えるために式を入力します。
[方向] : 昇順または降順を選択します。
[表示]
デフォルト設定では、レポートの実行時にグループは表示されますが、グループを非表示にしたり、ある条件を満たした場合のみ非表示にしたり、または別のレポートアイテムでの表示の切り替えなどが実現できます。
[レポートの初期実行時]
[次のレポートアイテムでの表示の切り替えを可能にする] : 他のレポートアイテムにトグルを表示するには、このチェックボックスをオンにします。ドロップダウンが有効になり、グループの表示を切り替えるためのレポートコントロールを指定します。ユーザーがトグルをクリックして、グループを表示または非表示にできます。
[データ出力]
[要素名] : このグループのXML出力に使用する名前を入力します。
[コレクション] : このグループのすべてのインスタンスのコレクションのXML出力に使用する名前を入力します。
[出力] : XML出力にこのグループを含めるかどうかを決定するため、[はい]または[いいえ]を選択します。
[レイアウト]
[先頭で改ページする] : グループの前に改ページを行います。
[末尾で改ページする] : グループの後に改ページを行います。
[グループヘッダを含める] : グループヘッダバンド(デフォルトで選択されている)を追加します。
[グループフッタを含める] : グループフッタバンド(デフォルトで選択されている)を追加します。
[グループヘッダを繰り返す] : ページごとにグループヘッダバンドを繰り返します。
[グループフッタを繰り返す] : ページごとにグループフッタバンドを繰り返します。
[フィルタ]
コレクションに新しいフィルタを追加するには、次の3つの値を設定する必要があります。
式: フィルタリングに使用する式を入力します。
演算子 : フィルタリングの方法を次の演算子から選択します。
値 : 選択された演算子に基づいて左側の式と比較する値を入力します。Between演算子を選択した場合、2つの値ボックスが有効になります。In演算子を選択した場合、多くの値を入力することができます。
[データ出力]
[BandedList]ダイアログの[データ出力]ページでは、XMLにエクスポートするときに次のプロパティを制御することができます。