ComponentChangingEventArgs Classe

Definição

Namespace:

System.ComponentModel.Design

Assembly:

System.ComponentModel.TypeConverter.dll

Origem:

ComponentChangingEventArgs.cs

Fornece dados para o evento de ComponentChanging . Essa classe não pode ser herdada.

public ref class ComponentChangingEventArgs sealed : EventArgs

public sealed class ComponentChangingEventArgs : EventArgs

type ComponentChangingEventArgs = class
    inherit EventArgs

Public NotInheritable Class ComponentChangingEventArgs
Inherits EventArgs

Herança

Object

EventArgs

ComponentChangingEventArgs

Exemplos

O exemplo a seguir demonstra a criação de um 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

Comentários

ComponentChangingEventArgs fornece dados sobre um ComponentChanging evento. O ComponentChanging evento notifica os IComponentChangeService manipuladores de eventos registrados e de que um componente específico no documento de design atual está prestes a ser alterado. Esse evento fornece um método amplamente acessível para impedir que um componente seja alterado.

Um ComponentChanging evento é gerado antes que um componente seja alterado. Esse evento oferece uma oportunidade para um designer anular a alteração. Os designers de componentes normalmente geram o ComponentChanging evento automaticamente. Se uma propriedade não puder ser alterada, o método que manipula o evento poderá gerar uma exceção. Por exemplo, se um arquivo de designer for verificado no controle do código-fonte, o manipulador desse evento normalmente gerará uma exceção se o usuário se recusar a marcar o arquivo.

Um ComponentChangingEventArgs fornece as seguintes informações:

• Uma Component propriedade que indica o componente que está prestes a ser modificado.

• Uma Member propriedade que indica o membro que está prestes a ser alterado.

Notas aos Herdeiros

Um erro do compilador ocorrerá se essa classe for especificada como a classe base de outra classe.

Construtores

ComponentChangingEventArgs(Object, MemberDescriptor)

Inicializa uma nova instância da classe ComponentChangingEventArgs.

Propriedades

Component	Obtém o componente que está prestes a ser alterado ou o componente que é o contêiner pai do membro que está prestes a ser alterado.
Member	Obtém o membro que está prestes a ser alterado.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• ComponentChanging
• ComponentChanged
• ComponentChangingEventHandler
• IComponentChangeService