List

Listは、他のレポートコントロールを配置して、任意の場所にレイアウトすることができるフリーフォームのデータ領域です。本レポート含むレポートコントロールについて、データセット内のレコードごとに繰り返して表示します。

Listで使用することができる主なプロパティを説明します。すべてのプロパティを表示するには、プロパティモードを**［詳細プロパティを表示］**にする必要があります。

データ

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

• 並び替えの式： データの並べ替えを行う場合、コレクションに式を追加します。［式］ボックスに、データの並べ替えに使用する式を入力し、［方向］オプションで並べ替えの方法を「昇順」、または**「降順」**に設定します。

• フィルタ： データのフィルタリングを行う場合、コレクションにフィルタを追加します。コレクションに新しいフィルタを追加するには、次の3つの値を設定する必要があります。

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

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

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

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

グループ

• 名前： まだレポートに使用されていない一意のグループの名前を入力します。

• 式： データをグループ化するために使用する式を入力します。

• 改ページ： リストの各インスタンスで、どの位置で改ページをするかを指定します。
  

  • Start： グループの前に改ページを行います。
    
  • End： グループの後に改ページを行います。
    
  • StartAndEnd： グループの前後に改ページを行います。

• 親： 再帰的な階層のために親グループとして使用する式を入力します。

• 見出しマップラベル： 目次（見出しマップ）にこのアイテムを表すためのラベルとして使用する式を入力します。

• グループ毎にページ番号を設定： グループ毎に独自のページ番号セクションを構成するため、グループ毎にページ番号を出力するかどうかを設定します。

背景

• 背景色： 背景として設定する色を選択します。

• 画像： 背景として設定する画像を選択します。

罫線

• 幅： 罫線の太さに設定する値をポイント単位で入力します。

• スタイル： 罫線のスタイルを選択します。

• 色： カラーピッカー、標準色、Webカラーから罫線の色を示すカラーを選択します。

レイアウト

• スタイル： 利用可能なスタイルのリストから選択し、コントロールに適用するように設定します。

• 改ページ： 改ページ設定を選択します。RDLレポートのみ有効です。
  

  • Start： リストの前に改ページを行います。
    
  • End： リストの後に改ページを行います。
    
  • StartAndEnd： リストの前後に改ページを行います。

• 新規セクション： データ領域毎に独自のページ番号セクションを構成するため、データ領域毎にページ番号を出力するかどうかを設定します。

• 1ページ内に収める： リストの途中で改ページを行うか設定します。設定し、リストが複数ページにまたがる場合は、出力前に改ページされます。RDLレポートのみ有効です。

• 空白を埋める： 余分な空白の出力を抑制するか設定します。RDLレポートのみ有効です。

データなし

• データが0件の場合のメッセージ： データ行がない場合、データ領域に表示するメッセージを設定します。

• 色： カラーピッカー、標準色、Webカラーからメッセージに使用するカラーを選択します。

• スタイル： テキストにフォントスタイルを適用します。**［レイアウト］＞［スタイル］**でテーマを選択した場合、テキストが選択したテーマに応じて表示されます。以下のオプションを選択できます。
  

  • Normal： 選択した文字列を通常文字にします。
    
  • Italic： 選択した文字列を斜体にします。
    

• 文字飾り： 線を使用してテキストを装飾できます。以下のオプションを選択できます。
  

  • Underline： テキストに下線を設定します。
    
  • Overline： テキストに上線を設定します。
    
  • LineThrough： テキストに取り消し線を設定します。

• 表示形式： ドロップダウンリストからテキストの数値書式を選択します。

使用例

次の例では、カテゴリごとに製品情報を表示するとともに、カテゴリ名とカテゴリの説明を表示する方法を示します。

このようなレポートを作成するには、Listデータ領域にレポートコントロールをドラッグ＆ドロップして配置します。同データ領域に含んでいるレポートコントロールについて、データセットのすべてのレコードが表示されます。TextBoxコントロールを使用して［CategoryName］および［Description］を表示し、Tableデータ領域を使用して各カテゴリに対応する詳細を表示します。また、Listデータ領域をグループ化するために式を使用しています。最終的には次の画像のようなレポートとなります。

**メモ：**この例ではレポートファイルに、以下のようなデータを埋め込み、使用します。

1. ページレポートを作成し、レポートのデザイン面上にListデータ領域をドラッグ＆ドロップして、そのサイズを調整します。また、次のプロパティを設定します。

   • 幅
   • 高さ
   • 固定の幅
   • 固定の高さ

2. Listデータ領域にTableデータ領域をドラッグ＆ドロップします。

3. Tableデータ領域の詳細行に製品に関する情報を表示するために、各テキストボックスをそれぞれ**［ProductName］、［UnitPrice**］、および**［ProductID］**のフィールドにバインドします。

4. TextBoxコントロールをテーブルの上にドラッグ＆ドロップし、［CategoryName］フィールドにバインドします。

5. 別のTextBoxコントロールをテーブルの上にドラッグ＆ドロップし、［Description］フィールドにバインドします。 レポートをプレビューすると、3つのレポートコントロールがすべて繰り返され、レポートを読むのが難しくなります。

   

6. グループ化するカテゴリごとに製品情報を表示するには、式を追加する必要があります。［CategoryName］フィールドは各カテゴリの一意の値であるため、データをグループ化するために使用します。

   1. Listデータ領域を選択し、**［グループ］セクションの［式］**プロパティに移動します。
   2. **［項目の表示］をクリックし、［+ 項目の追加］**を選択します。表示されるボックスに「=Fields!CategoryName.Value」式を入力します。

7. 次に、レポートの各ページにページ番号を追加します。TextBoxコントロールをページの下部（Listデータ領域の外側）にドラッグ＆ドロップします。**［値］**プロパティを「="Page " & Globals!PageNumber & " of " & Globals!TotalPages」に設定します。

8. レポートに配置する各コントロールのサイズや位置を調整して、レポートの外観をカスタマイズします。 　　

9. レポートをプレビューします。