バージョン

フィールド選択の概要

トピックの概要

目的

このトピックでは、xamPivotGrid™ に含まれているフィールド選択コントロールの概要について説明しています。

前提条件

以下の表に、このトピックを理解するための前提条件として求められるトピックをリストします。

トピック 目的

このセクションは xamPivotGrid コントロールの主要機能について説明します。ここに記載されているトピックでは、アプリケーションで xamPivotGrid コントロールを効果的に使用する方法が説明されています。

このトピックでは、xamPivotGrid コントロールを使用して作業を開始する方法について説明するため、このコントロールを WPF アプリケーションに追加するための手順を順を追って説明しています。

データでキューブをロード後、計算するデータのスライスの基礎とする階層を選択する必要があります。

フィールド選択コントロールの視覚要素と関連プロパティ

視覚要素の要約

フィールド選択は xamPivotGrid の一部であり、ユーザーがピボット グリッドの行、列、フィルター、およびメジャーとして使用するために選択可能な項目を指定できます。フィールド選択は 4 つの ItemsControls からなり、行、列、フィルター、およびメジャーについて選択可能な項目を指定できます。フィールド選択の目的は、xamPivotDataSelector™ の目的に少し似ています。

以下のスクリーンショットは、フィールド選択コントロールの視覚要素を示しています。設定可能な要素を図の後に示します。

xamPivotGrid FieldChooser Overview 1.png

構成可能な視覚要素:

1. FieldChooser ドロップダウン

これは、ドロップダウンを表示したときのフィールド選択の外観です。ドロップダウンを表示するには、その上のボタンを押します。

2. 行グループ ヘッダー

4 つの項目グループそれぞれに、任意のオブジェクトを設定できるヘッダーがあります。上のスクリーンショットでは、各グループの対応するテキスト (Rows、Columns、Filters、および Measures) が指定された TextBlocks がヘッダーに設定されています。

3. 列フィールドの選択グループ

すべてのフィールド選択グループはオプションであり、グループに項目が追加されていない場合は表示されません。

視覚要素と関連プロパティ

以下の表に、フィールド選択コントロールの視覚要素とそれを設定するプロパティのマッピングを示します。

視覚要素 プロパティ

フィールド選択

グループ ヘッダー

項目グループ

コントロールの構成の要約

コントロールの構成の概要

以下の表に、フィールド選択コントロールを設定するための主な方法を示します。

構成可能な点 詳細 プロパティ

フィールド選択グループへの FieldChooserItem クラスのインスタンスの設定。

フィールドの選択で FieldChooserItems を使用

カスタム型のオブジェクトを使用したフィールド選択グループの設定。

フィールド選択の項目に対するカスタム型の使用。

フィールド選択グループへの FieldChooserItem クラスのインスタンスの設定

概要

FieldChooserItem は ContentControl であり、 FieldChooserGroups の項目のデフォルトの型です。FieldChooserItem と FieldChooserGroup の関係は、ComboBoxItem と ComboBox の関係に似ています。カスタム型からフィールド選択グループに項目を追加すると、それぞれの項目は FieldChooser``Item に暗黙的にラップされます。

FieldChooserItem クラスでは、項目が対応する階層/メジャーを決定する FieldUniqueName プロパティが公開されています。Measures 以外のすべてのグループについて、このプロパティに、対象とする Hierarchy の UniqueName を設定する必要があります。メジャーの場合、FieldUniqueName は、対象とする Measure の UniqueName プロパティに一致する必要があります。

プロパティ設定

以下の表では、目的の構成をプロパティ設定にマップしています。

目的 使用するプロパティ: 手順

列コレクションに項目を追加する。

その Add メソッドを使用して FieldChooserItems を追加します。

または

XAML で、FieldChooser の Columns プロパティの中の項目を指定します。

このプロパティに FieldChooserItems のコレクションを設定します。

項目をフィルター コレクションに追加します。

その Add メソッドを使用して FieldChooserItems を追加します。

または

XAML で、FieldChooser の Filters プロパティの中の項目を指定します。

このプロパティに FieldChooserItems のコレクションを設定します。

項目を行コレクションに追加します。

その Add メソッドを使用して FieldChooserItems を追加します。

または

XAML で、FieldChooser の Rows プロパティの中の項目を指定します。

このプロパティに FieldChooserItems のコレクションを設定します。

項目をメジャー コレクションに追加します。

その Add メソッドを使用して FieldChooserItems を追加します。

または

XAML で、FieldChooser の Measures プロパティの中の項目を指定します。

このプロパティに FieldChooserItems のコレクションを設定します。

カスタム型のオブジェクトを使用したフィールド選択グループの設定

概要

フィールド選択グループ中の項目でカスタム クラスを使用する場合、次の重要な要件があります。

  • クラスには、一意の名前の文字列を格納する文字列プロパティが必要です。

  • 一意の名前プロパティのマッピングを作成する必要があります。そのためには、FieldChooser の FieldUniqueNameMemberPath プロパティに、一意の名前文字列を保持しているクラスのプロパティ名を設定する必要があります。たとえば、HierarchyName という文字列プロパティを持つ TestItem クラスがあるとします。また、UniqueName "[Seller].[Seller]" を持つ Hierarchy があるとします。ユーザーがこのフィールド選択を通じて xamPivotGrid の Columns 領域にこの階層を追加/削除できるようにするには、フィールド選択の FieldUniqueNameMemberPath プロパティに HierarchyName を設定する必要があります。その後、HierarchyName に [Seller].[Seller] を指定して TestItem インスタンスを作成し、列フィールド グループに追加する必要があります。

プロパティ設定

以下の表では、目的の構成をプロパティ設定にマップしています。

目的 使用するプロパティ: 手順

列コレクションに項目を追加する。

その Add メソッドを使用して FieldChooserItems を追加します。

または

XAML で、FieldChooser の Columns プロパティの中の項目を指定します。

このプロパティに FieldChooserItems のコレクションを設定します。

項目をフィルター コレクションに追加します。

その Add メソッドを使用して FieldChooserItems を追加します。

または

XAML で、FieldChooser の Filters プロパティの中の項目を指定します。

このプロパティに FieldChooserItems のコレクションを設定します。

項目を行コレクションに追加します。

その Add メソッドを使用して FieldChooserItems を追加します。

または

XAML で、FieldChooser の Rows プロパティの中の項目を指定します。

このプロパティに FieldChooserItems のコレクションを設定します。

項目をメジャー コレクションに追加します。

その Add メソッドを使用して FieldChooserItems を追加します。

または

XAML で、FieldChooser の Measures プロパティの中の項目を指定します。

このプロパティに FieldChooserItems のコレクションを設定します。

フィールド選択に、一意の名前文字列を保持しているクラスのプロパティを指示します。

クラスのプロパティ名を設定します。

フィールド選択に、項目の表示名を保持しているクラスのプロパティを指示します。

クラスのプロパティ名を設定します。

フィールド選択に、ターゲット コレクションに項目を追加する位置を決定するために使用する整数値を保持しているクラスのプロパティを指示します。

クラスのプロパティ名を設定します。

関連コンテンツ

以下のトピックでは、このトピックに関連する情報を提供しています。

トピック 目的

このトピックでは、xamPivotGrid でフィールド選択コントロールを使用する方法について、順を追って説明しています。

これは Field Chooser コントロールに関係する最も重要な API メンバーのリストです。

このトピックでは、xamPivotDataSelector™ コントロールの概要について説明しています。