ITypeDescriptorFilterService.FilterProperties(IComponent, IDictionary) メソッド

定義

TypeDescriptor を通じてコンポーネントが公開するプロパティをフィルター処理します。Filters the properties that a component exposes through a TypeDescriptor.

public:
 bool FilterProperties(System::ComponentModel::IComponent ^ component, System::Collections::IDictionary ^ properties);
public bool FilterProperties (System.ComponentModel.IComponent component, System.Collections.IDictionary properties);
abstract member FilterProperties : System.ComponentModel.IComponent * System.Collections.IDictionary -> bool
Public Function FilterProperties (component As IComponent, properties As IDictionary) As Boolean

パラメーター

component
IComponent

プロパティをフィルター処理する対象のコンポーネント。The component to filter properties for.

properties
IDictionary

変更できるプロパティのディクショナリ。A dictionary of properties that can be modified.

戻り値

Boolean

フィルター処理した一連のプロパティをキャッシュに保存する場合は true。フィルター サービスが再照会する必要がある場合は falsetrue if the set of filtered properties is to be cached; false if the filter service must query again.

注釈

このメソッドは、ユーザーがコンポーネントの一連のプロパティを要求したときに呼び出されます。This method is called when a user requests a set of properties for a component. プロパティは、キーとしてプロパティ名を持ち、対応するオブジェクトが値としてディクショナリに追加され PropertyDescriptor ます。The properties are added to the dictionary with the property names as the keys and the corresponding PropertyDescriptor objects as the values. このサービスの実装者は、ディクショナリ内のプロパティエントリを追加、削除、または変更できます。Implementers of this service can add, remove, or alter property entries in the dictionary.

注意 (実装者)

false型記述子フィルターサービスに対して繰り返しクエリを実行すると、パフォーマンスが低下する可能性があるため、必要な場合にのみを返します。Return false only when necessary, because repeated queries to the type descriptor filter service can decrease performance.

適用対象

こちらもご覧ください