バージョン

データのバインディングと視覚エフェクトの構成 (xamMultiColumnComboEditor)

トピックの概要

目的

このトピックでは、 xamMultiColumnComboEditor™ コントロールをデータとバインドして、コントロールのドロップダウン リストで項目レイアウトを構成する方法を説明します。

前提条件

このトピックを理解するためには、以下のトピックを理解しておく必要があります。

トピック 目的

このトピックでは、 xamMultiColumnComboEditor コントロールをアプリケーションに追加し、いくつかのプロパティを使用する方法について説明します。

データのバインディングと視覚エフェクトの構成の概要

データのバインディングと視覚エフェクトの構成の概要表

以下の表では、 xamMultiColumnComboEditor コントロールの構成可能な要素を簡単に説明し、それらを構成するプロパティにマップします。詳細は、表の後に記載されています。

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

xamMultiColumnComboEditor にデータを追加するには、xamMultiColumnComboEditor プロパティをデータ ソースに設定します。

データ オブジェクトの任意のIEnumerable コレクションを使用します。

列の自動生成を有効または無効にするには、 xamMultiColumnComboEditor AutoGenerateColumns プロパティを使用します。

xamMultiColumnComboEditor ドロップダウン リストの特定の列のみを表示するには、Columns コレクションのプロパティを使用します。

データ ソースへのバインディング

概要

xamMultiColumnComboEditor コントロールにデータを追加するには、 ItemsSource プロパティをデータ ソースに設定します。データ オブジェクトの任意のIEnumerable コレクションを使用します。

注:

Note

xamMultiColumnComboEditor が項目の直接追加をサポートしない場合は、項目をバインドするIEnumerable データ ソースが必要です。

注:

Note

xamMultiColumnComboEditor コントロールは、プリミティブ型のコレクションにバインドできません。

プロパティ設定

以下の表は、任意の構成とそれを管理するプロパティ設定のマップを示します。

目的: 使用するプロパティ: 設定値

xamMultiColumnComboEditor データ ソースの設定

IEnumerable

以下のスクリーンショットは、以下の設定の結果、 xamMultiColumnComboEditor の外観がどのようになるかを示しています。

プロパティ

{Binding Path=Products}

False

製品名

Configuring Data Population and Visualization 1.png

以下のコードはこの例を実装します。

XAML の場合:

<ig:XamMultiColumnComboEditor x:Name="ComboEditorProducts"
                              Height="30" Width="300"
                              ItemsSource="{Binding Path=Products}"
                              AutoGenerateColumns="False"
                              DisplayMemberPath="ProductName">
    <ig:XamMultiColumnComboEditor.Columns>
        <ig:TextComboColumn Key="ProductName"/>
        <ig:TextComboColumn Key="ProductID"/>
        <ig:TextComboColumn Key="UnitsInStock"/>
    </ig:XamMultiColumnComboEditor.Columns>
</ig:XamMultiColumnComboEditor>

列の自動生成の構成

概要

AutoGenerateColumns プロパティを使用して、 xamMultiColumnComboEditor 列の自動生成を有効または無効にします。

デフォルトでは列の自動生成は有効に設定されています。列は、ソース IEnumerable に含まれるデータ オブジェクトのすべてのパブリック プロパティに対し生成されます。

AutoGenerateColumns プロパティがFalse に設定されている場合は、 Columns コレクションのプロパティを使用して、表示する必要がある列を指定します。

プロパティ設定

以下の表は、任意の構成とそれを管理するプロパティ設定のマップを示します。

目的: 使用するプロパティ: 設定値

列の自動生成の構成

bool

表示する列の構成

概要

Columns プロパティを使用して、 xamMultiColumnComboEditor ドロップダウン リストで表示する列を指定します。

以下の使用可能な列タイプを使用します。

注:

Note

Uri を含むプロパティにキーをバインドする、またはタイプ BitmapImage のプロパティにバインドすると、画像を読み込むことができます。

プロパティ設定

以下の表は、任意の構成とそれを管理するプロパティ設定のマップを示します。

目的: 使用するプロパティ: 設定値

表示する列のコレクションの指定

関連コンテンツ

このトピックの追加情報については、以下のトピックも合わせてご参照ください。

トピック 目的

このトピックでは、 xamMultiColumnComboEditor コントロールのテキストフィールドに入力し Enter キーを押した場合に、実行される動作を構成する方法について説明します。

このトピックでは、 xamMultiColumnComboEditor ドロップダウンのレイアウトおよび動作を構成する方法を説明します。

このトピックでは、 xamMultiColumnComboEditor コントロールで項目のフィルタリングを構成する方法を説明します。

このグループのトピックでは、 xamMultiColumnComboEditor コントロールの選択機能とその使用方法について説明します。