このトピックでは、コントロールのプロパティ リストのフィルタリングを構成する方法を説明します。
このトピックを理解するために、以下のトピックを参照することをお勧めします。
このトピックは、以下のセクションで構成されます。
xamPropertyGrid コントロールにより、コントロール上端のフィルター領域にあるテキスト ボックスにフィルター値を入力できます。このフィルターは、表示されたプロパティ リストに追加するプロパティを評価する際に、「contains」フィルターとして使用されます。パイプ記号 (「|」) は、「Or」演算子を使用して組み合わされる複数のフィルター条件を指定するために使用できます。
コントロールの FilterText プロパティは、既定でフィルター領域のテキストボックスにバインドされています。そのため、常にエンド ユーザーが入力する現在の値を反映します。また、「And」演算子の使用によってユーザーが指定したフィルター条件と組み合わされる、コントロールの ItemFilters プロパティにより、プログラムでコントロールのカスタム フィルター (ICondition インターフェイスに基づく) を追加できます。
カスタム フィルターを作成する場合は、ICondition インターフェイスを実装する独自のクラスの使用、または提供されているクラスの 1 つ xamPropertyGrid アセンブリ - PropertyGridComparisonCondition、 PropertyGridComplementCondition および PropertyGridConditionGroup の使用が可能です。これらはそれぞれ、タイプ PropertyGridFilterOperandSource の OperandSource プロパティを公開します。このプロパティにより、特定の項目に対する要件の評価に使用する PropertyGridPropertyItem の値を指定することができます。
以下の表は、このトピックで使用したコード例をまとめたものです。
以下の例では、「Brush」または「Color」が名前に含まれるプロパティを表示するフィルターを追加する方法を示します。
以下のコードはこの例を実装します。
XAML の場合:
<ig:XamPropertyGrid>
<ig:XamPropertyGrid.ItemFilters>
<ig:PropertyGridConditionGroup LogicalOperator="Or">
<ig:PropertyGridComparisonCondition Operator="Contains" Value="Brush" />
<ig:PropertyGridComparisonCondition Operator="Contains" Value="Color" />
</ig:PropertyGridConditionGroup>
</ig:XamPropertyGrid.ItemFilters>
</ig:XamPropertyGrid>注:
注:
以下の例では、カテゴリ「Appearance」からのプロパティを表示するフィルターを追加する方法を示します。名前には「Visibility」が含まれます。
以下のコードはこの例を実装します。
XAML の場合:
<ig:XamPropertyGrid>
<ig:XamPropertyGrid.ItemFilters>
<ig:PropertyGridConditionGroup LogicalOperator="And">
<ig:PropertyGridComparisonCondition OperandSource="CategoryName"
Operator="Equals" Value="Appearance" />
<ig:PropertyGridComparisonCondition OperandSource="PropertyName"
Operator="Contains" Value="Visibility" />
</ig:PropertyGridConditionGroup>
</ig:XamPropertyGrid.ItemFilters>
</ig:XamPropertyGrid>注:
このトピックの追加情報については、以下のトピックも合わせてご参照ください。