Метод IUIAutomation::AddPropertyChangedEventHandlerNativeArray (uiautomationclient.h)
Регистрирует метод, обрабатывающий собственный массив событий изменения свойства.
Синтаксис
HRESULT AddPropertyChangedEventHandlerNativeArray(
[in] IUIAutomationElement *element,
TreeScope scope,
[in] IUIAutomationCacheRequest *cacheRequest,
[in] IUIAutomationPropertyChangedEventHandler *handler,
[in] PROPERTYID *propertyArray,
[in] int propertyCount
);
Параметры
[in] element
Тип: IUIAutomationElement*
Указатель на элемент модель автоматизации пользовательского интерфейса, связанный с обработчиком событий.
scope
[in] cacheRequest
Тип: IUIAutomationCacheRequest*
Указатель на запрос кэша или значение NULL , если кэширование не требуется.
[in] handler
Тип: IUIAutomationPropertyChangedEventHandler*
Указатель на объект, обрабатывающий событие.
[in] propertyArray
Тип: PROPERTYID*
Указатель на идентификаторы модель автоматизации пользовательского интерфейса интересующих свойств. Список идентификаторов свойств см. в разделе Идентификаторы свойств.
[in] propertyCount
Тип: int
Количество идентификаторов свойств в propertyArray.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
пример
Примеры кода, демонстрирующие реализацию интерфейсов, позволяющих клиентам получать и обрабатывать события Microsoft модель автоматизации пользовательского интерфейса (включая AddPropertyChangedEventHandlerNativeArray), см. в статье Реализация обработчиков событий.
Комментарии
Элемент пользовательского интерфейса, заданный элементом , может не поддерживать свойства, заданные параметром propertyArray .
Этот метод служит той же цели, что и IUIAutomation::AddPropertyChangedEventHandler, но принимает обычный массив идентификаторов свойств вместо SAFEARRAY.
Клиент модель автоматизации пользовательского интерфейса не должен использовать несколько потоков для добавления или удаления обработчиков событий. Непредвиденное поведение может привести к добавлению или удалению одного обработчика событий в то время как другой добавляется или удаляется в том же клиентском процессе.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | 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) |
См. также раздел
AddPropertyChangedEventHandler
Основные понятия
Справочные материалы
RemovePropertyChangedEventHandler
Подписка на события модель автоматизации пользовательского интерфейса
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по