Метод IUIAutomation::AddPropertyChangedEventHandler (uiautomationclient.h)
Регистрирует метод, обрабатывающий и массив событий изменения свойства.
Синтаксис
HRESULT AddPropertyChangedEventHandler(
[in] IUIAutomationElement *element,
TreeScope scope,
[in] IUIAutomationCacheRequest *cacheRequest,
[in] IUIAutomationPropertyChangedEventHandler *handler,
[in] SAFEARRAY *propertyArray
);
Параметры
[in] element
Тип: IUIAutomationElement*
Указатель на элемент модель автоматизации пользовательского интерфейса, связанный с обработчиком событий.
scope
[in] cacheRequest
Тип: IUIAutomationCacheRequest*
Указатель на запрос кэша или значение NULL , если кэширование не требуется.
[in] handler
Тип: IUIAutomationPropertyChangedEventHandler*
Указатель на объект, обрабатывающий событие.
[in] propertyArray
Тип: SAFEARRAY*
Указатель на интересующие свойства модель автоматизации пользовательского интерфейса. Список идентификаторов свойств см. в разделе Идентификаторы свойств.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Элемент пользовательского интерфейса, заданный элементом , может не поддерживать свойства, заданные параметром propertyArray .
Клиент модель автоматизации пользовательского интерфейса не должен использовать несколько потоков для добавления или удаления обработчиков событий. Непредвиденное поведение может привести к добавлению или удалению одного обработчика событий в то время как другой добавляется или удаляется в том же клиентском процессе.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista, Windows XP с пакетом обновления 3 (SP3) и Обновление платформы для Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [только классические приложения] |
Целевая платформа | Windows |
Header | uiautomationclient.h (включая UIAutomation.h) |
См. также раздел
AddPropertyChangedEventHandlerNativeArray
Рекомендации по использованию безопасных массивов
Основные понятия
Справочные материалы
RemovePropertyChangedEventHandler
Подписка на события модель автоматизации пользовательского интерфейса
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по