Метод IRawElementProviderAdviseEvents::AdviseEventAdded (uiautomationcore.h)

Уведомляет поставщика microsoft модель автоматизации пользовательского интерфейса, когда клиент модель автоматизации пользовательского интерфейса начинает прослушивать определенное событие, включая событие изменения свойства.

Синтаксис

HRESULT AdviseEventAdded(
  [in] EVENTID   eventId,
  [in] SAFEARRAY *propertyIDs
);

Параметры

[in] eventId

Тип: EVENTID

Идентификатор добавляемого события. Список идентификаторов событий см. в разделе Идентификаторы событий.

[in] propertyIDs

Тип: SAFEARRAY*

Указатель на идентификаторы добавляемых свойств или значение NULL , если добавляемый прослушиватель событий не прослушивает события свойства.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод позволяет поставщику сократить затраты, вызывая только события, которые прослушиваются.

Для поставщиков модель автоматизации пользовательского интерфейса важно обрабатывать IRawElementProviderAdviseEvents::AdviseEventAdded как метод AddRef интерфейса IUnknown. До тех пор, пока функция AdviseEventAdded вызывается больше раз, чем AdviseEventRemoved для определенного события или свойства, поставщик должен продолжать вызывать соответствующие события, так как некоторые клиенты по-прежнему прослушивают. Кроме того, поставщики модель автоматизации пользовательского интерфейса могут использовать функцию UiaClientsAreListening, чтобы определить, прослушивает ли хотя бы один клиент, и, если да, вызывает все соответствующие события.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	uiautomationcore.h (включая UIAutomation.h)

См. также раздел

Рекомендации по использованию безопасных массивов

Основные понятия

IRawElementProviderAdviseEvents

Справочные материалы