EventDescriptor Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece informações sobre um evento.
public ref class EventDescriptor abstract : System::ComponentModel::MemberDescriptor
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EventDescriptor : System.ComponentModel.MemberDescriptor
public abstract class EventDescriptor : System.ComponentModel.MemberDescriptor
[<System.Runtime.InteropServices.ComVisible(true)>]
type EventDescriptor = class
inherit MemberDescriptor
type EventDescriptor = class
inherit MemberDescriptor
Public MustInherit Class EventDescriptor
Inherits MemberDescriptor
- Herança
- Atributos
Exemplos
O seguinte exemplo de código é construído sobre o exemplo da EventDescriptorCollection classe. Imprime a informação (categoria, descrição e nome de exibição) de cada evento num botão numa caixa de texto. Requer isso button1 e textbox1 ter sido instanciado num formulário.
EventDescriptorCollection^ events = TypeDescriptor::GetEvents( button1 );
// Displays each event's information in the collection in a text box.
for each (EventDescriptor^ myEvent in events) {
textBox1->Text += myEvent->Category + '\n';
textBox1->Text += myEvent->Description + '\n';
textBox1->Text += myEvent->DisplayName + '\n';
}
EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);
// Displays each event's information in the collection in a text box.
foreach (System.ComponentModel.EventDescriptor myEvent in events)
{
textBox1.Text += myEvent.Category + '\n';
textBox1.Text += myEvent.Description + '\n';
textBox1.Text += myEvent.DisplayName + '\n';
}
Dim events As EventDescriptorCollection = TypeDescriptor.GetEvents(Button1)
' Displays each event's information in the collection in a text box.
Dim myEvent As EventDescriptor
For Each myEvent In events
TextBox1.Text &= myEvent.Category & ControlChars.Cr
TextBox1.Text &= myEvent.Description & ControlChars.Cr
TextBox1.Text &= myEvent.DisplayName & ControlChars.Cr
Next myEvent
Observações
An EventDescriptor consiste num nome, os seus atributos, o componente ao qual o evento está vinculado, o delegado do evento, o tipo de delegado e se o delegado é multicast.
EventDescriptor fornece as seguintes abstract propriedades e métodos:
ComponentType contém o tipo do componente onde este evento é declarado.
EventType contém o tipo de delegado para o evento.
IsMulticast contém um valor que indica se o delegado do evento é um delegado multicast.
AddEventHandler liga o evento a um componente.
RemoveEventHandler desvincula o delegado do componente para que o delegado deixe de receber eventos do componente.
Para mais informações sobre eventos, consulte Gestão e Angariação de Eventos. Para mais informações sobre reflexão, consulte os tópicos em Reflexão.
Construtores
| Name | Description |
|---|---|
| EventDescriptor(MemberDescriptor, Attribute[]) |
Inicializa uma nova instância da EventDescriptor classe com o nome no especificado MemberDescriptor e os atributos tanto no MemberDescriptor como no Attribute array. |
| EventDescriptor(MemberDescriptor) |
Inicializa uma nova instância da EventDescriptor classe com o nome e os atributos no especificado MemberDescriptor. |
| EventDescriptor(String, Attribute[]) |
Inicializa uma nova instância da EventDescriptor classe com o nome especificado e o array de atributos. |
Propriedades
| Name | Description |
|---|---|
| AttributeArray |
Obtém ou define um conjunto de atributos. (Herdado de MemberDescriptor) |
| Attributes |
Obtém a coleção de atributos deste membro. (Herdado de MemberDescriptor) |
| Category |
Obtém o nome da categoria à qual o membro pertence, conforme especificado no CategoryAttribute. (Herdado de MemberDescriptor) |
| ComponentType |
Quando sobrescrito numa classe derivada, obtém o tipo de componente a que este evento está ligado. |
| Description |
Obtém a descrição do membro, conforme especificado no DescriptionAttribute. (Herdado de MemberDescriptor) |
| DesignTimeOnly |
Obtém se este elemento deve ser definido apenas na altura do projeto, conforme especificado no DesignOnlyAttribute. (Herdado de MemberDescriptor) |
| DisplayName |
Recebe o nome que pode ser exibido numa janela, como uma janela Propriedades. (Herdado de MemberDescriptor) |
| EventType |
Quando é sobreposto numa classe derivada, obtém o tipo de delegado para o evento. |
| IsBrowsable |
Obtém um valor que indica se o membro é navegável, conforme especificado no BrowsableAttribute. (Herdado de MemberDescriptor) |
| IsMulticast |
Quando sobrescrito numa classe derivada, obtém um valor que indica se o delegado do evento é um delegado multicast. |
| Name |
Obtém o nome do membro. (Herdado de MemberDescriptor) |
| NameHashCode |
Obtém o código de hash para o nome do membro, conforme especificado em GetHashCode(). (Herdado de MemberDescriptor) |
Métodos
| Name | Description |
|---|---|
| AddEventHandler(Object, Delegate) |
Quando sobreposto numa classe derivada, liga o evento ao componente. |
| CreateAttributeCollection() |
Cria uma coleção de atributos usando o array de atributos passados ao construtor. (Herdado de MemberDescriptor) |
| Equals(Object) |
Compara esta instância com o objeto dado para ver se são equivalentes. (Herdado de MemberDescriptor) |
| FillAttributes(IList) |
Quando sobreposto numa classe derivada, adiciona os atributos da classe herdeira à lista especificada de atributos na classe mãe. (Herdado de MemberDescriptor) |
| GetHashCode() |
Devolve o código de hash para esta instância. (Herdado de MemberDescriptor) |
| GetInvocationTarget(Type, Object) |
Recupera o objeto que deve ser usado durante a invocação dos membros. (Herdado de MemberDescriptor) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| RemoveEventHandler(Object, Delegate) |
Quando sobrescrito numa classe derivada, desvincula o delegado do componente para que o delegado deixe de receber eventos do componente. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |