ComponentChangingEventArgs クラス

2008-03-28

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

この型のすべてのメンバの一覧については、ComponentChangingEventArgs メンバを参照してください。

System.Object
System.EventArgs
System.ComponentModel.Design.ComponentChangingEventArgs

<ComVisible(True)>
NotInheritable Public Class ComponentChangingEventArgs   Inherits EventArgs
[C#]
[ComVisible(true)]
public sealed class ComponentChangingEventArgs : EventArgs
[C++]
[ComVisible(true)]
public __gc __sealed class ComponentChangingEventArgs : public   EventArgs
[JScript]
public
   ComVisible(true)
class ComponentChangingEventArgs extends EventArgs

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

ComponentChangingEventArgs は、 ComponentChanging イベントに関するデータを提供します。 ComponentChanging イベントは、 IComponentChangeService および登録されているイベントハンドラに対して、現在のデザインドキュメント内の特定のコンポーネントが変更されようとしていることを通知します。このイベントにより、さまざまな状況で、コンポーネントが変更されることを回避できます。

ComponentChanging イベントは、コンポーネントが変更される前に発生します。このイベントを発生させることで、デザイナで変更を中止する機会を作ることができます。通常、コンポーネントデザイナは ComponentChanging イベントを自動的に発生させます。プロパティを変更できない場合、このイベントを処理するメソッドは例外をスローすることがあります。たとえば、デザイナファイルがソースコード管理にチェックインされていて、ユーザーがそのファイルのチェックアウトを拒否している場合、このイベントのハンドラは例外をスローします。

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

変更されようとしているコンポーネントを示す Component プロパティ。
変更されようとしているメンバを示す Member プロパティ。

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

使用例

[Visual Basic, C#, C++] ComponentChangingEventArgs を作成する例を次に示します。

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

    ' The component that is about to change:       args.Component
    ' The member that is about to change:          args.Member

    Return args
End Function

[C#] 
// This example method creates a ComponentChangingEventArgs using the specified arguments.
// Typically, this type of event args is created by a design mode subsystem.  
public ComponentChangingEventArgs CreateComponentChangingEventArgs(object component, MemberDescriptor member)
{
    ComponentChangingEventArgs args = new ComponentChangingEventArgs(component, member);

    // The component that is about to change:       args.Component
    // The member that is about to change:          args.Member

    return args;
}

[C++] 
// This example method creates a ComponentChangingEventArgs using the specified arguments.
// Typically, this type of event args is created by a design mode subsystem.
ComponentChangingEventArgs* CreateComponentChangingEventArgs(Object* component, MemberDescriptor* member)
{
    // The component that is about to change:       args.Component
    // The member that is about to change:          args.Member

    return new ComponentChangingEventArgs(component, member);
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.ComponentModel.Design

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System (System.dll 内)

参照

次の方法で共有

ComponentChangingEventArgs クラス

スレッドセーフ

解説

使用例

必要条件

参照

その他のリソース