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

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

  • Статья

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

Синтаксис

HRESULT NormalizeElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **normalized
);

Параметры

[in] element

Тип: IUIAutomationElement*

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

[out, retval] normalized

Тип: IUIAutomationElement**

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

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

Тип: HRESULT

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

Комментарии

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

Метод возвращает UIA_E_ELEMENTNOTAVAILABLE , если соответствующий элемент не найден.

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

Требования

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