Поделиться через

Интерфейс IRawElementProviderAdviseEvents (uiautomationcore.h)

  • Статья

Предоставляет методы, вызываемые для уведомления корневого элемента фрагмента, когда клиентское приложение Microsoft модель автоматизации пользовательского интерфейса начинает или заканчивает прослушивание событий в этом фрагменте.

Наследование

Интерфейс IRawElementProviderAdviseEvents наследуется от интерфейса IUnknown . IRawElementProviderAdviseEvents также имеет следующие типы элементов:

Методы

Интерфейс IRawElementProviderAdviseEvents содержит следующие методы.

 
IRawElementProviderAdviseEvents::AdviseEventAdded

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

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

Комментарии

Реализация этого интерфейса является необязательной. Его можно использовать для повышения производительности, вызывая события только при их прослушивании.

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

Требования

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