バージョン

xamGrid コントロールの代わりに xamDataGrid コントロールを使用してください。xamGrid は数年以内に廃止する予定のため、新しい機能の追加はありません。xamGrid のサポートおよび重要なバグ修正は廃止時まで提供されます。コードベースの xamDataGrid への移動に関する質問は、サポートまでお問い合わせください。

カスタム フィルター ダイアログの使用

トピックの概要

目的

このトピックでは、xamGrid™ のカスタム フィルター ダイアログ機能、およびエンド ユーザーがダイアログ インターフェイスを使って列のデータに複合フィルターを作成する方法について説明します。

前提条件

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

トピック 目的

このトピックでは、エンド ユーザーが xamGrid コントロールに含まれるデータをフィルターする方法を説明します。

本トピックの内容

このトピックには次のセクションがあります。

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

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

以下の表は、xamGrid コントロールのカスタム フィルター ダイアログのフィルタリングおよび効化の構成可能な特性を示しています。詳細については、概要表の後をご覧ください。

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

カスタム フィルター ダイアログの有効化

エンド ユーザーがカスタム フィルター ダイアログにアクセスできるようにするには、FilterMenu を通してフィルタリングを有効にする必要があります。

カスタム フィルター ダイアログの有効化

概要

xamGrid コントロールのフィルタリングおよびフィルター メニューを有効にすると、 エンド ユーザーはカスタム フィルター ダイアログにアクセスできます。

プロパティ設定

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

以下を行うために: プロパティ 次に設定

カスタム フィルター ダイアログを有効にします

FilterMenu

以下のスクリーンショットは、以下の設定によってフィルタリングを有効にした後の、フィルター メニューおよびカスタム フィルター ダイアログの外観を示しています。

プロパティ

FilterMenu

xamGrid Using the Custom Filter Dialog 1.png

図 1 FilterMenu アイコン

xamGrid Using the Custom Filter Dialog 2.png

図 2 フィルター メニューを開く

xamGrid Using the Custom Filter Dialog 3.png

図 3 カスタム フィルター メニュー

ユーザー相互作用と操作性

ユーザー相互作用の概要

以下の表は、xamGrid コントロールのカスタム フィルター ダイアログの、ユーザー インタラクション機能の概要を示しています。表の後に、その他の詳細が紹介されています。

ユーザーは以下を実行できます…​ 次の使用…​ 詳細 クライアント/サーバー設定

新しいフィルタリング条件の追加

条件の追加 ボタン

このボタンをクリックすると、フィルタリング条件グリッドに新規エントリが作成されます。

xamGrid Using the Custom Filter Dialog 4.png

フィルタ オペランドの編集

フィルタ オペランド フィールドのコンボ ボックス

フィルタ オペランド フィールドには編集可能なコンボ ボックスが含まれており、フィルターされた列のデータ タイプに適切なすべてのオペランドが表示されます。

xamGrid Using the Custom Filter Dialog 4.png

フィルター値の編集

フィルター値 フィールドのエディター

フィルター値 フィールドには、フィルターされた列のデータ タイプ用の特定のエディターが含まれています。

xamGrid Using the Custom Filter Dialog 4.png

選択された条件を削除します

条件の削除 ボタン

このボタンをクリックすると、選択した条件が削除されます。

xamGrid Using the Custom Filter Dialog 4.png

And グループで 2 つ以上の選択した条件を組み合わせます

And Group ボタン

このボタンをクリックすると、2 つ以上の選択した条件が AND 演算子と結合され、括弧でグループが囲まれます。

xamGrid Using the Custom Filter Dialog 4.png

Or グループで 2 つ以上の選択した条件を組み合わせます

Or Group ボタン

このボタンをクリックすると、2 つ以上の選択した条件が OR 演算子と結合され、括弧でグループが囲まれます。

xamGrid Using the Custom Filter Dialog 4.png

論理演算子 AND および OR を切り替えます

Toggle ボタン

このボタンをクリックすると、選択した条件の間で論理演算子が切り替わります

xamGrid Using the Custom Filter Dialog 4.png

新しく作成した複合フィルターの承認および適用

Accept ボタン

このボタンをクリックすると、新しく作成した複合フィルターが列データに適用されます。

xamGrid Using the Custom Filter Dialog 4.png

作成したフィルターを適用せずにダイアログを閉じます

Cancel ボタン

このボタンをクリックすると、作成したフィルターを列データに適用せずにダイアログが閉じます。

xamGrid Using the Custom Filter Dialog 4.png

関連内容

トピック

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

トピック 目的

このトピックは、xamGrid コントロールのフィルタリング イベントについて説明します。

このトピックでは、フィルターをプログラムで作成する方法を示します。

このトピックでは、xamGrid コントロールに新しいカスタム フィルターを追加する方法を示します。

このトピックでは、特定のフィルタ オペランドの変更方法、または特定のフィルタ オペランドをフィルター行から削除する方法を示します。