IComponentChangeService.OnComponentChanged メソッド

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

IComponentChangeService.OnComponentChanged メソッド

コンポーネント変更サービスに対して、特定のコンポーネントが変更されたことを通知します。

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

Visual Basic (宣言)

Sub OnComponentChanged ( _
    component As Object, _
    member As MemberDescriptor, _
    oldValue As Object, _
    newValue As Object _
)

Visual Basic (使用法)

Dim instance As IComponentChangeService
Dim component As Object
Dim member As MemberDescriptor
Dim oldValue As Object
Dim newValue As Object

instance.OnComponentChanged(component, member, oldValue, newValue)

C#

void OnComponentChanged (
    Object component,
    MemberDescriptor member,
    Object oldValue,
    Object newValue
)

C++

void OnComponentChanged (
    Object^ component, 
    MemberDescriptor^ member, 
    Object^ oldValue, 
    Object^ newValue
)

J#

void OnComponentChanged (
    Object component, 
    MemberDescriptor member, 
    Object oldValue, 
    Object newValue
)

JScript

function OnComponentChanged (
    component : Object, 
    member : MemberDescriptor, 
    oldValue : Object, 
    newValue : Object
)

パラメータ

component

変更されたコンポーネント。

member

変更されたメンバ。変更が単一のメンバに関連していない場合は null 参照 (Visual Basic では Nothing) になります。

oldValue

変更前のメンバの値。メンバが null 参照 (Visual Basic では Nothing) ではない場合にだけ有効です。

newValue

変更後のメンバの値。メンバが null 参照 (Visual Basic では Nothing) ではない場合にだけ有効です。

解説

このメソッドは、ComponentChanged イベントを発生させます。

.NET Framework SDK に同梱されているほとんどのデザイナと Visual Studio .NET デザイン時環境は、通常プロジェクト内のコンポーネントが変更された場合にこのイベントを発生させます。このため、ほとんどの場合、このメソッドを明示的に呼び出す必要はありません。PropertyDescriptor を使用してプロパティ値を変更したり、IDesignerHost コンテナに対してコンポーネントを追加または削除したりすると、適切な IComponentChangeService イベントが自動的に発生します。

OnComponentChanged を呼び出す場合は、その前に OnComponentChanging を呼び出してコンポーネントがこれから変更されることを示してから、実際の変更を行います。OnComponentChanged を呼び出すと、ComponentChanged イベントが発生します。

実装時の注意 このイベントを利用して、プロパティが変更された後に必要とされる後処理を実行できます。たとえば、通常、デザイナはプロパティに新しい値を設定するソース コードを更新します。

プラットフォーム

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

参照

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