ComponentChangedEventArgs クラス

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

ComponentChangedEventArgs クラス

ComponentChanged イベントのデータを提供します。このクラスは継承できません。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public NotInheritable Class
 ComponentChangedEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As ComponentChangedEventArgs

C#

[ComVisibleAttribute(true)] 
public sealed class ComponentChangedEventArgs
 : EventArgs

C++

[ComVisibleAttribute(true)] 
public ref class ComponentChangedEventArgs
 sealed : public EventArgs

J#

/** @attribute ComVisibleAttribute(true) */ 
public final class ComponentChangedEventArgs
 extends EventArgs

JScript

ComVisibleAttribute(true) 
public final class ComponentChangedEventArgs
 extends EventArgs

解説

ComponentChangedEventArgs は、ComponentChanged イベントに関するデータを提供します。ComponentChanged イベントは、IComponentChangeService および登録されているイベント ハンドラに対して、現在アクティブなドキュメント内の特定のコンポーネントが変更されたことを通知します。

ComponentChangedEventArgs は、次の情報を提供します。

• 変更されたコンポーネントを示す Component プロパティ。

• 変更されたメンバを示す Member プロパティ。

• メンバの変更後の値を示す NewValue プロパティ。

• メンバの変更前の値を示す OldValue プロパティ。

通常、コンポーネント デザイナは、コンポーネントが追加、削除、または変更されたときに ComponentChanged イベントを自動的に発生させます。フォームの読み込み時やアンロード時の変更は当然行われるため、これらの処理時には ComponentChanged イベントは発生しません。コンポーネント デザイナは、コンポーネントのプロパティを変更した後で ComponentChanged イベントを発生させることもあります。これにより、プロパティ ウィンドウに更新後のプロパティ値が表示されます。

メモ
このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、SharedState です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

継承時の注意 このクラスが別のクラスの基本クラスとして指定されると、コンパイラ エラーが発生します。

使用例

ComponentChangedEventArgs を作成する例を次に示します。

Visual Basic

' This example method creates a ComponentChangedEventArgs using the
 specified arguments.
' Typically, this type of event args is created by a design mode subsystem.
            
Public Function CreateComponentChangedEventArgs(ByVal
 component As Object, ByVal
 member As MemberDescriptor, ByVal oldValue As Object, ByVal newValue As Object)
 As ComponentChangedEventArgs
    ' Creates a component changed event args with the specified arguments.
    Dim args As New ComponentChangedEventArgs(component,
 member, oldValue, newValue)

    ' The component that has changed:              args.Component
    ' The member of the component that changed:    args.Member
    ' The old value of the member:                 args.oldValue
    ' The new value of the member:                 args.newValue
    Return args
End Function

C#

// This example method creates a ComponentChangedEventArgs using the
 specified arguments.
// Typically, this type of event args is created by a design mode subsystem.
            
public ComponentChangedEventArgs CreateComponentChangedEventArgs(object
 component, MemberDescriptor member, object oldValue, object newValue)
{            
    // Creates a component changed event args with the specified arguments.
    ComponentChangedEventArgs args = new ComponentChangedEventArgs(component
,
 member, oldValue, newValue);

    // The component that has changed:              args.Component
    // The member of the component that changed:    args.Member
    // The old value of the member:                 args.oldValue
    // The new value of the member:                 args.newValue

    return args;            
}

C++

public:
   // This example method creates a ComponentChangedEventArgs using the
 specified arguments.
   // Typically, this type of event args is created by a design mode
 subsystem.
   ComponentChangedEventArgs^ CreateComponentChangedEventArgs( Object^ component,
 MemberDescriptor^ member, Object^ oldValue, Object^ newValue )
   {
      // Creates a component changed event args with the specified arguments.
      ComponentChangedEventArgs^ args = gcnew ComponentChangedEventArgs( component,
 member, oldValue, newValue );
      
      // The component that has changed:              args->Component
      // The member of the component that changed:    args->Member
      // The old value of the member:                 args->oldValue
      // The new value of the member:                 args->newValue
      return args;
   }

J#

// This example method creates a ComponentChangedEventArgs using 
// the specified arguments.
// Typically, this type of event args is created by a design mode subsystem.
            
public ComponentChangedEventArgs CreateComponentChangedEventArgs(
    Object component, MemberDescriptor member, Object oldValue, 
    Object newValue)
{
    // Creates a component changed event args with the specified arguments.
    ComponentChangedEventArgs args = new ComponentChangedEventArgs(component
,
        member, oldValue, newValue);
    // The component that has changed:              args.Component
    // The member of the component that changed:    args.Member
    // The old value of the member:                 args.oldValue
    // The new value of the member:                 args.newValue
    return args;
} //CreateComponentChangedEventArgs

継承階層

System.Object
   System.EventArgs
    System.ComponentModel.Design.ComponentChangedEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
ComponentChangedEventArgs メンバ
System.ComponentModel.Design 名前空間
ComponentChanged
ComponentChanging
ComponentChangedEventHandler
IComponentChangeService