ITypeDescriptorFilterService.FilterProperties メソッド

.NET Framework クラス ライブラリ リファレンス

ITypeDescriptorFilterService.FilterProperties メソッド

TypeDescriptor を通じてコンポーネントが公開するプロパティをフィルタ処理します。

名前空間: System.ComponentModel.Design
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Function FilterProperties ( _
    component As IComponent, _
    properties As IDictionary _
) As Boolean

Visual Basic (使用法)

Dim instance As ITypeDescriptorFilterService
Dim component As IComponent
Dim properties As IDictionary
Dim returnValue As Boolean

returnValue = instance.FilterProperties(component, properties)

C#

bool FilterProperties (
    IComponent component,
    IDictionary properties
)

C++

bool FilterProperties (
    IComponent^ component, 
    IDictionary^ properties
)

J#

boolean FilterProperties (
    IComponent component, 
    IDictionary properties
)

JScript

function FilterProperties (
    component : IComponent, 
    properties : IDictionary
) : boolean

パラメータ

component

プロパティをフィルタ処理する対象のコンポーネント。

properties

変更できるプロパティのディクショナリ。

戻り値
フィルタ処理した一連のプロパティをキャッシュに保存する場合は true。フィルタ サービスが再照会する必要がある場合は false。

解説

このメソッドは、コンポーネントの一連のプロパティが要求されたときに呼び出されます。プロパティは、プロパティ名をキーとして、また対応する PropertyDescriptor オブジェクトを値として設定して、ディクショナリに追加されます。このサービスを実装すると、ディクショナリ内のプロパティ エントリを追加、削除、または変更できます。

実装時の注意 型記述子フィルタ サービスへのクエリを繰り返すとパフォーマンスが低下するため、false を返すのは必要な場合だけにします。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ITypeDescriptorFilterService インターフェイス
ITypeDescriptorFilterService メンバ
System.ComponentModel.Design 名前空間
PropertyDescriptor クラス
IDictionary