EventDescriptor Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет сведения о событии.
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
- Наследование
- Атрибуты
Примеры
Следующий пример кода основан на примере в EventDescriptorCollection классе. Он печатает информацию (категорию, описание и отображаемое имя) каждого события на кнопке в текстовом поле. Для этого требуется button1textbox1 создать экземпляр в форме.
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
Комментарии
Объект EventDescriptor состоит из имени, его атрибутов, компонента, к которому привязано событие, делегат события, тип делегата и многоадресная рассылка делегата.
EventDescriptor предоставляет следующие abstract свойства и методы:
ComponentType содержит тип компонента, в котором объявляется это событие.
EventType содержит тип делегата для события.
IsMulticast содержит значение, указывающее, является ли делегат события делегатом многоадресной рассылки.
AddEventHandler привязывает событие к компоненту.
RemoveEventHandler отменяет привязку делегата из компонента, чтобы делегат больше не получал события от компонента.
Дополнительные сведения о событиях см. в разделе "Обработка и создание событий". Дополнительные сведения о отражении см. в разделах в разделе "Отражение".
Конструкторы
| Имя | Описание |
|---|---|
| EventDescriptor(MemberDescriptor, Attribute[]) |
Инициализирует новый экземпляр EventDescriptor класса с именем в указанном MemberDescriptor и атрибутах в MemberDescriptor массиве Attribute . |
| EventDescriptor(MemberDescriptor) |
Инициализирует новый экземпляр EventDescriptor класса с именем и атрибутами в указанном MemberDescriptor. |
| EventDescriptor(String, Attribute[]) |
Инициализирует новый экземпляр EventDescriptor класса с указанными именами и массивом атрибутов. |
Свойства
| Имя | Описание |
|---|---|
| AttributeArray |
Возвращает или задает массив атрибутов. (Унаследовано от MemberDescriptor) |
| Attributes |
Возвращает коллекцию атрибутов для этого элемента. (Унаследовано от MemberDescriptor) |
| Category |
Возвращает имя категории, к которой принадлежит член, как указано в разделе CategoryAttribute. (Унаследовано от MemberDescriptor) |
| ComponentType |
При переопределении в производном классе получает тип компонента, к которым привязано это событие. |
| Description |
Возвращает описание элемента, как указано в разделе DescriptionAttribute. (Унаследовано от MemberDescriptor) |
| DesignTimeOnly |
Возвращает, следует ли задать этот элемент только во время разработки, как указано в параметре DesignOnlyAttribute. (Унаследовано от MemberDescriptor) |
| DisplayName |
Возвращает имя, которое можно отобразить в окне, например окно "Свойства". (Унаследовано от MemberDescriptor) |
| EventType |
При переопределении в производном классе получает тип делегата для события. |
| IsBrowsable |
Возвращает значение, указывающее, доступен ли элемент для просмотра, как указано в разделе BrowsableAttribute. (Унаследовано от MemberDescriptor) |
| IsMulticast |
При переопределении в производном классе получает значение, указывающее, является ли делегат события делегатом многоадресной рассылки. |
| Name |
Возвращает имя члена. (Унаследовано от MemberDescriptor) |
| NameHashCode |
Возвращает хэш-код для имени члена, как указано в GetHashCode(). (Унаследовано от MemberDescriptor) |
Методы
| Имя | Описание |
|---|---|
| AddEventHandler(Object, Delegate) |
При переопределении в производном классе привязывает событие к компоненту. |
| CreateAttributeCollection() |
Создает коллекцию атрибутов с помощью массива атрибутов, передаваемых конструктору. (Унаследовано от MemberDescriptor) |
| Equals(Object) |
Сравнивает этот экземпляр с заданным объектом, чтобы узнать, эквивалентны ли они. (Унаследовано от MemberDescriptor) |
| FillAttributes(IList) |
При переопределении в производном классе добавляет атрибуты наследующего класса в указанный список атрибутов родительского класса. (Унаследовано от MemberDescriptor) |
| GetHashCode() |
Возвращает хэш-код для этого экземпляра. (Унаследовано от MemberDescriptor) |
| GetInvocationTarget(Type, Object) |
Извлекает объект, который следует использовать во время вызова элементов. (Унаследовано от MemberDescriptor) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| RemoveEventHandler(Object, Delegate) |
При переопределении в производном классе отменяет привязку делегата от компонента, чтобы делегат больше не получал события от компонента. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |