バージョン

ドロップダウン サイズの構成 (xamComboEditor)

トピックの概要

目的

このトピックは、 xamComboEditor™ のドロップダウンのサイズ変更を有効/無効にする方法を説明し、ドロップダウンの最小/最大の幅および高さをコードで設定する方法を説明します。

前提条件

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

トピック 目的

このトピックでは、 xamComboEditor コントロールを開始する方法、およびプロシージャ コードを使用してページに追加する方法を説明します。

ドロップダウン サイズ変更の構成の概要

ドロップダウン サイズ変更の構成の概要表

以下の表は、 xamComboEditor ドロップダウン サイズ変更機能の構成可能な要素を簡単に説明し、それらを構成するプロパティにマップします。詳細は、表の後に記載されています。

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

ドロップダウンがサイズ変更ハンドルでサイズ変更できるかどうかを構成します。

ドロップダウンの最小幅の構成

ドロップダウンの最大幅の構成

ドロップダウンの最小の高さを構成します。

ドロップダウンの最大の高さの構成

ユーザーによるドロップダウン サイズ変更の有効化/無効化

概要

xamComboEditor ドロップダウンは、サイズ変更ハンドルを使用して、すべての項目情報が使用できるようにドロップダウンをサイズ変更できます。

xamComboEditor ドロップダウンのサイズ変更機能は、デフォルトで有効に設定されています。

プロパティ設定

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

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

xamComboEditor ドロップダウンのサイズ変更機能の有効化/無効化

bool

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

プロパティ

true

Manipulating the drop down size 1.png

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

XAML の場合:

<ig:XamComboEditor x:Name="ComboEditor"
                   DisplayMemberPath="ContactName"
                   AllowDropDownResizing="True" />

ドロップダウンの最小幅の構成

概要

xamComboEditor MinDropDownWidth プロパティを使用して、ドロップダウンの最小幅を指定します。

プロパティのデフォルト設定は、double.NaN です。

MinDropDownWidth プロパティの値が設定されていない場合、ドロップダウンの最小幅は xamComboEditor コントロールのテキスト入力フィールドの幅に制限されます。

MinDropDownWidth 値が MaxDropDownWidth 値より大きい場合、ドロップダウンは水平方向にサイズ変更できなくなり、幅は MinDropDownWidth 値に設定されます。

注:

Note

MinDropDownWidth プロパティに負の値が設定されている場合は、System.ArgumentException が発生します。

プロパティ設定

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

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

サイズ変更中のドロップダウンの最小幅を制限する

double

以下のスクリーンショットは、以下の設定の結果、 xamComboEditor ドロップダウンがどのように動作するかを示しています。

プロパティ

150

Manipulating the drop down size 2.png

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

XAML の場合:

<ig:XamComboEditor x:Name="ComboEditor"
                   DisplayMemberPath="ContactName" MinDropDownWidth="150" />

ドロップダウンの最大幅の構成

概要

xamComboEditor MaxDropDownWidth プロパティを使用して、ドロップダウンの最大幅を指定します。

プロパティのデフォルト設定は、double.PositiveInfinity です。

注:

Note

MaxDropDownWidth プロパティに負の値が設定されている場合は、System.ArgumentException が発生します。

プロパティ設定

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

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

サイズ変更中のドロップダウンの最大幅を制限する

double

以下のスクリーンショットは、以下の設定の結果、 xamComboEditor ドロップダウンがどのように動作するかを示しています。

プロパティ

350

Manipulating the drop down size 3.png

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

XAML の場合:

<ig:XamComboEditor x:Name="ComboEditor"
                   DisplayMemberPath="ContactName" MaxDropDownWidth="350" />

ドロップダウンの最小の高さの構成

概要

xamComboEditor MinDropDownHeight プロパティを使用して、ドロップダウンの最小の高さを指定します。

プロパティのデフォルト設定は、0.0 です。

MinDropDownHeight プロパティの値が設定されない場合、ドロップダウンの最小の高さは 20 px に設定されます。

MinDropDownHeight 値が MaxDropDownHeight 値より大きい場合、ドロップダウンは垂直方向にサイズ変更できなく、高さは MinDropDownHeight 値に設定されます。

注:

Note

MinDropDownHeight プロパティに負の値が設定されている場合は、System.ArgumentException が発生します。

プロパティ設定

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

目的: 使用するプロパティ: 設定の選択肢:

サイズ変更およびフィルター操作でドロップダウンの最小の高さを制限する

double

以下のスクリーンショットは、以下の設定の結果、 xamComboEditor ドロップダウンがどのように動作するかを示しています。

プロパティ

70

Manipulating the drop down size 5.png

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

XAML の場合:

<ig:XamComboEditor x:Name="ComboEditor" DisplayMemberPath="ContactName"
MinDropDownHeight="70" />

ドロップダウンの最大の高さの構成

概要

xamComboEditor MaxDropDownHeight プロパティを使用して、ドロップダウンの最大の高さを指定します。

プロパティのデフォルト設定は、double.PositiveInfinity です。

このプロパティが正しく設定できない場合、コントロールの概算によって、上下にスペースができます。ドロップダウン リストは、アプリケーションの使用可能な高さの範囲で制限されます。

注:

Note

MaxDropDownHeight プロパティに負の値が設定されている場合は、System.ArgumentException が発生します。

プロパティ設定

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

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

サイズ変更およびフィルター操作でドロップダウンの最大の高さを制限する

double

以下のスクリーンショットは、以下の設定の結果、 xamComboEditor ドロップダウンがどのように動作するかを示しています。

プロパティ

200

Manipulating the drop down size 4.png

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

XAML の場合:

<ig:XamComboEditor x:Name="ComboEditor"
                   DisplayMemberPath="ContactName"
                   MaxDropDownHeight="200" />

関連コンテンツ

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

トピック 目的

このトピックでは、 xamComboEditor コントロールの編集可能モードで有効になるオートコンプリート機能について説明します。

このトピックでは、 xamComboEditor コントロールのテキスト ボックスを指定する方法を説明します。

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

このトピックでは、 xamComboEditor ItemTemplate プロパティを使用して、項目の視覚エフェクトをカスタマイズする方法を説明します。

このトピックでは、 xamComboEditor コントロールでの選択について説明します。