ActiveReports for .NET 18.0J
List
ActiveReportsユーザーガイド > 概念 > ページレポート/RDLレポートの概念 > ページレポート/RDLレポートのレポートコントロール > List

Listデータ領域は、同データ領域に含んでいるレポートコントロールについて、データセットのすべてのレコードを表示します。Listデータ領域はフリーフォームなので、他のデータ領域とは異なり、レポートコントロールを任意の場所にレイアウトすることができます。

List内のグループ化は詳細行で行われます。

プロパティ設定ダイアログ

Listデータ領域の各プロパティは、プロパティ設定ダイアログで設定することができます。このダイアログを表示するには、レポート上のListデータ領域を選択した状態で、[プロパティ]ウィンドウ内にある[プロパティ設定ダイアログ]のリンクをクリックします。表示される[List]ダイアログが、Listデータ領域のプロパティ設定ダイアログにあたります。

[List]ダイアログでは、以下の各ページを使用してListデータ領域のプロパティを設定することができます。

メモ: プロパティの多くに用意されている<式...>オプションをクリックすると、[式エディタ]ダイアログが表示されます。このダイアログでは、値を決定する式を作成することができます。

[全般]

[名前]: まだレポートに使用されていない一意のList名前を入力します。この名前はコード内で呼び出すことができます。

[ツールヒント]: HTMLレポートでTITLE属性やALT属性を表示するために使用されるレポートアイテムのテキストラベル。

[データセット名]: Listと関連付けるデータセットを選択します。このドロップダウンリストには、レポートのデータセットコレクションにあるすべてのデータセットが表示されます。

[グループ毎にページ番号を設定]: データ領域毎にページ番号を出力するかどうかを設定します。

[詳細行のグループ化]

詳細行のグループ化は、重複値を表示したくない場合に便利です。詳細行のグループ化を設定すると、グループが変更された場合にのみ表示します。

例えば、NorthwindデータベースのCustomersテーブルを使用する場合、詳細行のグループ化を設定しないで国のリストを作成すると、国名は各データに対して表示されます。一方、詳細行のグループ化を=Fields!Country.Value」設定した場合、国名は一度しか表示されません。

メモ: 各データで異なる値を表示する場合(例 顧客ID)は、変化はありません。

Listダイアログの[詳細行のグループ化]のページには、以下のページタブが含まれます。

[全般]

[名前]: まだレポートに使用されていない一意のListの名前を入力します。このプロパティは、[グループ化の条件]の[式]を入力しないと設定することができません。

[グループ化の条件]: データをグループ化するために使用する式を入力します。

[見出しマップラベル]: 目次(見出しマップ)でこのアイテムを表すためのラベルとして使用する式を入力します。

[親グループ]: 再帰階層の場合に使用します。親グループとして使用する式を入力します。

[フィルタ]

コレクションにフィルタを追加するには、次の3つの値を設定する必要があります。

: フィルタリングに使用する式を入力します。

演算子: フィルタリングの方法を次の演算子から選択します。

  • Equal: 一致するデータが選択されます。
  • Like: 左側の値が右側の値と同様であるデータが選択されます。
    Like演算子の詳細情報については、「MSDN ウェブサイト」を参照してください。
  • NotEqual: 一致しないデータが選択されます。
  • GreaterThan: 指定した値より大きな値のデータが選択されます。
  • GreaterThanOrEqual: 指定した値以上のデータが選択されます。
  • LessThan: 指定した値未満のデータが選択されます。
  • LessThanOrEqual: 指定した値以下のデータが選択されます。
  • TopN: 上位N番目までのデータが選択されます。
  • BottomN: 下位N番目までのデータが選択されます。
  • TopPercent: 累積合計が指定された割合以上になる、上位のデータが選択されます。
  • BottomPercent: 累積合計が指定された割合以上になる、下位のデータが選択されます。
  • In: 指定した値のリストに含まれるデータのみが選択されます。
  • Between: 指定した2つの値の間に入るデータが選択されます。

: 選択された演算子に基づいて左側の式と比較する値を入力します。Between演算子を選択した場合、2つの値ボックスが有効になります。In演算子を選択した場合、多くの値を入力することができます。

[並べ替え]

[追加](+)ボタンをクリックして並べ替えの新しい式を入力します。また、[削除](X)ボタンを使用して削除します。

[式]ボックスに、グループ内にデータの並べ替えに使用する式を入力します。また、[方向]オプションで並べ替えの方法を「昇順」または「降順」に設定します。

[データ出力]

[要素名]: このグループのXML出力に使用する名前を入力します。

[コレクション]: このグループのすべてのインスタンスのコレクションのXML出力に使用する名前を入力します。

[出力]: XML出力にこのグループを含めるかどうかを設定します。

[レイアウト]

[改ページ位置]: 次のオプションから選択して、グループに改ページを挿入する位置を決定します。

  • None:改ページを挿入しません。
  • Start:グループの前に改ページを挿入します。
  • End:グループの後に改ページを挿入します。
  • StartAndEnd:グループの前後に改ページを挿入します。
  • Between:グループ間(現在のグループの終了位置と次のグループの開始位置)に改ページを挿入します。

[グループ毎にページ番号を設定]: データ領域毎にページ番号を出力するかどうかを設定します。

[表示]

[レポートの初期実行時

[次のレポートアイテムでの表示の切り替えを可能にする]: 他のレポートコントロールを使用して表示を切り替えるには、このチェックボックスをオンにします。ドロップダウンが有効になり、Listの表示を切り替えるためのTextBoxコントロールを指定します。プレビュー時に、指定したレポートコントロールに隣接して表示されるトグルボタンをクリックすることにより、表示を切り替えることができます。

[ナビゲーション]

[見出しマップラベル]: 目次(見出しマップ)でこのアイテムを表示するためのラベルとして使用する式を入力します。

[ブックマークID]: Listコントロールの位置を示すIDを入力します。[ブックマークに移動]アクションと組み合わせて使用することにより、他のレポートコントロールからこの項目にリンクすることができます。

[フィルタ]

コレクションに新しいフィルタを追加するには、次の3つの値を設定する必要があります。

: フィルタリングに使用する式を入力します。

演算子: フィルタリングの方法を次の演算子から選択します。

: 選択された演算子に基づいて左側の式と比較する値を入力します。Between演算子を選択した場合、2つの値ボックスが有効になります。In演算子を選択した場合、多くの値を入力することができます。

[並べ替え]

追加(+)ボタンをクリックして並べ替えの新しい式を入力します。また、削除(X)ボタンを使用して削除します。

[式]ボックスに、グループ内でデータの並べ替えに使用する式を入力します。また、[方向]オプションで並べ替えの方法を「昇順」、または「降順」に設定します。

[データ出力]

[要素名]: このListをXML出力に使用する場合の名前を入力します。

[出力]: XML出力にこのListを含めるかどうかを決定するため、[自動]、[はい][いいえ]のいずれかを選択します。[自動]を選択すると、Listの内容がエクスポートされます。

[インスタンス要素名]: このListのインスタンスのコレクションのXML出力に使用する名前を入力します。詳細行のグループ化を指定している場合は、この名前は無視されます。

[インスタンス要素の出力形式]: XML出力にこのListを含めるかどうかを決定するため、[自動]、[はい][いいえ]のいずれかを選択します。詳細行のグループ化を指定している場合は、この名前は無視されます。


Webデザイナ

Webデザイナに表示されるプロパティは、以下の通りです。

List

カテゴリ プロパティ 説明
全般 名前​ 名前を設定します。
アクション​ 種類​ クリックしたときに実行するアクションを設定します。
データ データセット 表示するデータセットを設定します。
データセットパラメータ データセットに渡すパラメータを設定します。
要素名 データ出力で使用する要素の名前を設定します。
要素出力 データ出力でデータを出力するかどうかを設定します。
インスタンスの要素名 データ出力で使用するインスタンスの要素の名前を設定します。
インスタンスの要素出力 データ出力でインスタンスを出力するかどうかを設定します。
並べ替えの式 並べ替えの式を設定します。
フィルタ データを抽出するフィルタを設定します。
オーバーフローデータの連結先 オーバーフローしたデータを表示する連結先を設定します。
グループ 名前​ グループの名前を設定します。
データをグループ化するための式を設定します。
改ページ 改ページのタイミングを設定します。
親グループ 親グループを設定します。
ラベル 目次に表示するラベルを設定します。
要素名 データ出力で使用する要素の名前を設定します。
コレクション名 データ出力で使用するコレクションの名前を設定します。
要素出力 データ出力でデータを出力するかどうかを設定します。
グループ毎にページ番号を設定 グループ毎にページ番号をカウントするかどうかを設定します。
フィルタ データを抽出するフィルタを設定します。
背景 背景色 背景色を設定します。
画像​ 背景に表示する画像を設定します。
罫線 太さ 罫線の太さを設定します。
スタイル 罫線の種類を設定します。
罫線の色を設定します。
位置とサイズ 左位置を設定します。
上位置を設定します。
幅を設定します。
高さ 高さを設定します。
固定の幅 拡張できる幅の上限を設定します。
固定の高さ 拡張できる高さの上限を設定します。
レイアウト スタイル スタイル名を設定します。
パディング 罫線との間のパディング(余白)を設定します。
レイヤー名 含まれるレイヤーの名前を設定します。
改ページ 改ページのタイミングを設定します。
新ページ 改ページ後に、ページを開始する位置を設定します。
データ領域毎にページ番号を設定 データ領域毎にページ番号をカウントするかどうかを設定します。
1ページ内に収める 1ページ内に収めて表示するかどうかを設定します。
空白を埋める 空白スペースを削除するかどうかを設定します。
行または列のカウント 行または列の数を設定します。
レイアウト方向 レイアウトする方向を設定します。
Zインデックス レポートアイテム同士の重なりの優先順位を設定します。
データなし データがない場合のメッセージ データがない場合に表示するメッセージを設定します。
テキストの色を設定します。
フォント名 フォントの種類を設定します。
サイズ フォントのサイズを設定します。
スタイル フォントのスタイルを設定します。
太さ フォントの太さを設定します。
文字飾り テキストの下、上、または中央に線を追加します。
水平方向の整列 テキストの水平方向の配置を設定します。
垂直方向の整列 テキストの垂直方向の配置を設定します。
表示形式 日付、数値の表示書式を設定します。
表示 非表示 非表示にするかどうかを設定します。
トグルスイッチにする項目 表示/非表示の切り替えに使うテキストボックスの名前を設定します。
インターナショナル カレンダー 日付の書式設定に使用するカレンダーを設定します。
方向 テキストの表示方向を設定します(左書き、右書き)。
言語 テキストの主要言語を設定します。
桁形式 桁形式を設定します。
桁形式の言語変種 桁形式の変化形を設定します。
Unicodeの文字表記の方向 左書き、右書きが混在する場合の文字表記の方向を設定します。
縦中横 縦書きの中で特定の文字を横向き表示するかどうかを設定します。
文字表記の方向 テキストの表示方向を設定します(横書き、縦書き)。
その他 ツールチップ カーソルを合わせたときに表示するテキストを設定します。
ラベル 目次に表示するラベルを設定します。
ブックマークID ブックマークのIDを設定します。