ComponentChangingEventArgs クラス

定義

名前空間:

System.ComponentModel.Design

アセンブリ:

System.dll

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

public ref class ComponentChangingEventArgs sealed : EventArgs

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ComponentChangingEventArgs : EventArgs

[<System.Runtime.InteropServices.ComVisible(true)>]
type ComponentChangingEventArgs = class
    inherit EventArgs

Public NotInheritable Class ComponentChangingEventArgs
Inherits EventArgs

継承

Object

EventArgs

ComponentChangingEventArgs

属性

ComVisibleAttribute

例

次の例では、 ComponentChangingEventArgsの作成を示します。

public:
   // 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 gcnew ComponentChangingEventArgs( component,member );
   }

// 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;
}

' 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

注釈

ComponentChangingEventArgs は、 ComponentChanging イベントに関するデータを提供します。 ComponentChanging イベントは、現在のデザイン ドキュメント内の特定のコンポーネントが変更されようとしていることをIComponentChangeServiceおよび登録されたイベント ハンドラーに通知します。 このイベントは、コンポーネントが変更されないように、広くアクセス可能なメソッドを提供します。

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

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

• 変更しようとしているコンポーネントを示す Component プロパティです。

• 変更しようとしているメンバーを示す Member プロパティ。

注意 (継承者)

このクラスが別のクラスの基底クラスとして指定されている場合、コンパイラ エラーが発生します。

コンストラクター

名前	説明
ComponentChangingEventArgs(Object, MemberDescriptor)	ComponentChangingEventArgs クラスの新しいインスタンスを初期化します。

プロパティ

名前	説明
Component	変更しようとしているコンポーネント、または変更しようとしているメンバーの親コンテナーであるコンポーネントを取得します。
Member	変更される予定のメンバーを取得します。

メソッド

名前	説明
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• ComponentChanging
• ComponentChanged
• ComponentChangingEventHandler
• IComponentChangeService