Метод IUIAutomation::AddPropertyChangedEventHandlerNativeArray (uiautomationclient.h)

Статья
08/08/2024

Регистрирует метод, обрабатывающий собственный массив событий, измененных свойств.

Примечание Перед реализацией обработчика событий необходимо ознакомиться с проблемами потоков, описанными в статье Основные сведения о проблемах потоков.

Синтаксис

HRESULT AddPropertyChangedEventHandlerNativeArray(
  [in] IUIAutomationElement                     *element,
  [in] TreeScope                                scope,
  [in] IUIAutomationCacheRequest                *cacheRequest,
  [in] IUIAutomationPropertyChangedEventHandler *handler,
  [in] PROPERTYID                               *propertyArray,
  [in] int                                      propertyCount
);

Параметры

[in] element

Тип: IUIAutomationElement*

Указатель на элемент автоматизации пользовательского интерфейса, связанный с обработчиком событий.

[in] scope

Тип: TreeScope

Область обработки событий; то есть, находятся ли они на самом элементе, или на своих предках и детях.

[in] cacheRequest

Тип: IUIAutomationCacheRequest*

Указатель на запрос кэша или NULL, если кэширование не требуется.

[in] handler

Тип: IUIAutomationPropertyChangedEventHandler*

Указатель на объект, обрабатывающий событие.

[in] propertyArray

Тип: PROPERTYID*

Указатель на идентификаторы свойств автоматизации пользовательского интерфейса, интересующих вас. Список идентификаторов свойств см. в разделе Идентификаторы свойств.

[in] propertyCount

Тип: int

Количество идентификаторов свойств в свойствArray.

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

Тип: HRESULT

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

пример

Примеры кода, демонстрирующие реализацию интерфейсов, позволяющих клиентам получать и обрабатывать события автоматизации пользовательского интерфейса Майкрософт (включая 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 [классические приложения только]
целевая платформа	Виндоус
заголовка	uiautomationclient.h (include UIAutomation.h)