バージョン

xamMultiColumnComboEditor をページに追加

トピックの概要

目的

このトピックでは、xamMultiColumnComboEditor™ コントロールをアプリケーションに追加し、より重要ないくつかのプロパティの使用方法を示します。

前提条件

まず以下のトピックを読む必要があります。

構成の概要

以下の表は、xamMultiColumnComboEditor コントロールの構成可能な動作の一部を説明しています。

構成可能な動作

構成の詳細

構成プロパティ

xamMultiColumnComboEditor コントロールをアプリケーションに追加するために必要な手順。

なし

xamMultiColumnComboEditor を項目で生成

xamMultiColumnComboEditor を項目と読み込む

コントロールの主なプロパティの一部を構成します。

コントロールの選択された項目を取得します。

xamMultiColumnComboEditor を アプリケーションに追加

  1. Infragistics 名前空間を追加します。

    1. 必要な参照を追加します。

xamMultiColumnComboEditor をアプリケーションに追加するには、以下の NuGet パッケージへの参照をプロジェクトに追加する必要があります。

  • Infragistics.WPF.Controls.Editors.XamComboEditor

    NuGet フィードのセットアップと NuGet パッケージの追加の詳細については、NuGet フィード ドキュメントを参照してください。

    1. Infragistics 名前空間を追加します。

XAML の場合:

xmlns:ig="http://schemas.infragistics.com/xaml"

Visual Basic の場合:

Imports Infragistics.Controls.Editors

C# の場合:

using Infragistics.Controls.Editors;

  1. xamMultiColumnComboEditor コントロールを追加します。

XAML の場合:

<ig:XamMultiColumnComboEditor/>

Visual Basic の場合:

Dim multiColumnCombo As XamMultiColumnComboEditor = New XamMultiColumnComboEditor()

C# の場合:

XamMultiColumnComboEditor multiColumnCombo = new XamMultiColumnComboEditor();

xamMultiColumnComboEditor を項目で生成

目的

プロパティ

設定値

IEnumerable データ ソース

  1. Key プロパティを設定します。

XAML の場合:

<ig:XamMultiColumnComboEditor ItemsSource="[your IEnumerable source]"/>

Visual Basic の場合:

multiColumnCombo.ItemsSource = "[your IEnumerable source]"

C# の場合:

multiColumnCombo.ItemsSource = "[your IEnumerable source]";

xamMultiColumnComboEditor の修正

以下の表では、望ましい構成をプロパティ設定にマップしています。プロパティは xamMultiColumnComboEditor コントロールから直接アクセスされます。

目的

プロパティ

設定値

選択したブール値

選択されたプロパティの名前。

ComboColumns のコレクション

選択したブール値

選択した System.Windows.Visibility

XamMultiColumnComboEditor の詳細を修正

  1. コントロールに列を生成させます。

xamMultiColumnComboEditor コントロールの設定で重要な部分は列の生成です。以下によってコントロールに自動的に列を生成させることができます:

XAML の場合:

<ig:XamMultiColumnComboEditor AutoGenerateColumns="True"/>

Visual Basic の場合:

multiColumnCombo.AutoGenerateColumns = True

C# の場合:

multiColumnCombo.AutoGenerateColumns = true;

  1. ドロップダウンが閉じたときに表示される列の値を設定します。

選択した項目を表示するためにコントロールによって使用されるプロパティを定義するには、コントロールの DisplayMemberPath プロパティをプロパティ名と同じに設定します。

XAML の場合:

<ig:XamMultiColumnComboEditor DisplayMemberPath="[Property Name]"/>

Visual Basic の場合:

multiColumnCombo.DisplayMemberPath = "[Property Name]"

C# の場合:

multiColumnCombo.DisplayMemberPath = "[Property Name]";

  1. コントロールのドロップダウンに表示される列を定義します (AutoGenerateColumns が False に設定されている場合)。

コントロールで列を手動で選択して配列したい場合、AutoGenerateColumns プロパティを false に設定し、xamMultiColumnComboEditor コントロールの Columns Collection を設定します:

XAML の場合:

<ig:XamMultiColumnComboEditor.Columns>
        <ig:TextComboColumn Key="ContactName"/>
        <ig:TextComboColumn Key="Company"/>
</ig:XamMultiColumnComboEditor.Columns>

Visual Basic の場合:

multiColumnCombo.AutoGenerateColumns = False
Dim colContactName = New TextComboColumn()
Dim colCompany = New TextComboColumn()
colContactName.Key = "ContactName"
colCompany.Key = "Company"
multiColumnCombo.Columns.Add(colConactName)
multiColumnCombo.Columns.Add(colCompany)

C# の場合:

multiColumnCombo.AutoGenerateColumns = false;
var colContactName = new TextComboColumn();
var colCompany = new TextComboColumn();
colContactName.Key = "ContactName";
colCompany.Key = "Company";
multiColumnCombo.Columns.Add(colContactName);
multiColumnCombo.Columns.Add(colCompany);

  1. ユーザーにコントロールで複数の項目を選択することを許可します。

ユーザーに xamMultiColumnComboEditor から複数の項目を選択させたい場合には、AllowMultipleSelection プロパティを true に設定します。

XAML の場合:

<ig:XamMultiColumnComboEditor AllowMultipleSelection="True"/>

Visual Basic の場合:

multiColumnCombo.AllowMultipleSelection = True

C# の場合:

multiColumnCombo.AllowMultipleSelection = true;

  1. あらゆる項目の前にチェックボックスを表示定義します。

ユーザーに xamMultiColumnComboEditor から複数の項目を選択させたい場合には、AllowMultipleSelection プロパティを true に設定します。

XAML の場合:

<ig:XamMultiColumnComboEditor CheckBoxVisibility="Visible"/>

Visual Basic の場合:

multiColumnCombo.CheckBoxVisibility = System.Windows.Visibility.Visible

C# の場合:

multiColumnCombo.AllowMultipleSelection = System.Windows.Visibility.Visible;

xamMultiColumnComboEditor の使用

選択された項目は以下を使用することによって取得できます:

目的

プロパティ

そして …

選択された項目の ObservableCollection<object> を取得します。

項目をデータ モデルから取得または設定します。

選択された項目のインデックスを取得または設定します。

XamMultiColumnComboEditor の詳細を使用

  1. 選択された項目コレクションを取得します。

AllowMultipleSelection プロパティが true に設定されると、SelectedItems プロパティにアクセスすることによって選択された項目コレクションを取得できます:

Visual Basic の場合:

Dim selItems = multiColumnCombo.SelectedItems

C# の場合:

var selItems =  multiColumnCombo.SelectedItems;

  1. 選択した項目を取得または設定します。

  1. 選択された項目を取得します。

AllowMultipleSelection プロパティが false に設定されると、SelectedItem プロパティにアクセスすることによって選択された項目を取得できます:

Visual Basic の場合:

Dim selItem = multiColumnCombo.SelectedItem

C# の場合:

int selItem = multiColumnCombo.SelectedItem;

  1. 選択された項目を設定します。

AllowMultipleSelection プロパティが false に設定されると、データ ソース コレクションからの項目のインスタンスを SelectedItem プロパティと等しく割り当てることによって選択された項目を設定できます:

XAML の場合:

<ig:XamMultiColumnComboEditor SelectedItem="[an item from the data mode]"/>

Visual Basic の場合:

multiColumnCombo.SelectedItem = [an item from the data mode]

C# の場合:

multiColumnCombo.SelectedItem = [an item from the data mode];

  1. 選択したインデックスを取得または設定します。

  1. 選択されたインデックスを取得します。

SelectedIndex プロパティにアクセスすることによって選択されたインデックスを取得できます:

Visual Basic の場合:

Dim selIndex = multiColumnCombo.SelectedIndex

C# の場合:

int selIndex = multiColumnCombo.SelectedIndex;

  1. 選択された項目を設定します。

インデックス値を SelectedIndex プロパティに割り当てることによって選択されたインデックスを設定できます:

XAML の場合:

<ig:XamMultiColumnComboEditor SelectedIndex="[your index value]"/>

Visual Basic の場合:

multiColumnCombo.SelectedIndex = [your index value]

C# の場合:

multiColumnCombo.SelectedIndex = [your index value];

関連トピック

以下は、その他の役立つトピックです。

xamMultiColumnComboEditor について

xamMultiColumnComboEditor の構成