Функция обратного вызова UiaEventCallback (uiautomationcoreapi.h)

Статья
08/26/2023

Примечание Эта функция является нерекомендуемой. Клиентские приложения должны использовать вместо этого интерфейсы COM модели компонентов автоматизации пользовательского интерфейса Майкрософт.

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

Синтаксис

UiaEventCallback Uiaeventcallback;

void Uiaeventcallback(
  [in] UiaEventArgs *pArgs,
  [in] SAFEARRAY *pRequestedData,
  [in] BSTR pTreeStructure
)
{...}

Параметры

[in] pArgs

Тип: UiaEventArgs*

Адрес структуры UiaEventArgs , содержащей аргументы события.

[in] pRequestedData

Тип: SAFEARRAY*

SAFEARRAY, содержащий данные, связанные с событием.

[in] pTreeStructure

Тип: BSTR

Строка, содержащая структуру дерева, связанного с событием, если событие связано с набором узлов. См. заметки.

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

None

Remarks

Эта функция передается в UiaAddEvent и UiaRemoveEvent.

Древовидная структура описывается строкой, где каждый символ имеет значение "p" или ""). Первый символ в строке всегда представляет корневой узел. Строка имеет значение NULL , если функция не возвращает никаких элементов.

"p" представляет узел (элемент автоматизации пользовательского интерфейса). Если одно "p" следует непосредственно за другим, второй узел является дочерним по отношению к первому. "") представляет собой шаг резервного копирования дерева. Например, "pp)p" представляет узел, за которым следуют два дочерних узла, которые являются общими элементами друг друга. В "pp))p" последний узел является одноуровневый узел первого узла.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	uiautomationcoreapi.h

Share via