Compartilhar via


ComponentChangingEventArgs Classe

Definição

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
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ComponentChangingEventArgs : EventArgs
type ComponentChangingEventArgs = class
    inherit EventArgs
[<System.Runtime.InteropServices.ComVisible(true)>]
type ComponentChangingEventArgs = class
    inherit EventArgs
Public NotInheritable Class ComponentChangingEventArgs
Inherits EventArgs
Herança
ComponentChangingEventArgs
Atributos

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)

Aplica-se a

Confira também