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

Метод IUIAutomationTreeWalker::NormalizeElementBuildCache (uiautomationclient.h)

  • Статья

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

Синтаксис

HRESULT NormalizeElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **normalized
);

Параметры

[in] element

Тип: IUIAutomationElement*

Указатель на элемент, с которого начинается нормализация.

[in] cacheRequest

Тип: IUIAutomationCacheRequest*

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

[out, retval] normalized

Тип: IUIAutomationElement**

Получает указатель на элемент-предок, ближайший к указанному элементу в представлении дерева.

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

Тип: HRESULT

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

Комментарии

Элемент нормализуется путем перехода вверх по цепочке предков в дереве до достижения элемента, удовлетворяющего условию представления (заданному предыдущим вызовом IUIAutomationTreeWalker::Condition). Если корневой элемент достигнут, возвращается корневой элемент, даже если он не соответствует условию представления.

Этот метод полезен для приложений, которые получают ссылки на элементы автоматизации пользовательского интерфейса путем проверки попадания. Приложение может работать только с определенными типами элементов и может использовать IUIAutomationTreeWalker::NormalizeElement , чтобы убедиться, что независимо от того, какой элемент изначально извлекается (например, когда полоса прокрутки получает фокус ввода), в конечном итоге извлекается только интересующий элемент (например, элемент содержимого).

Требования

   
Минимальная версия клиента 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)