Метод IUIAutomationCacheRequest::get_AutomationElementMode (uiautomationclient.h)

Статья
08/26/2023

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

Это свойство доступно для чтения и записи.

Синтаксис

HRESULT get_AutomationElementMode(
  AutomationElementMode *mode
);

Параметры

mode

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

None

Remarks

AutomationElementMode_Full является значением по умолчанию и указывает, что возвращаемые элементы содержат полную ссылку на базовый пользовательский интерфейс. AutomationElementMode_None указывает, что возвращаемые элементы не имеют ссылки на базовый пользовательский интерфейс и содержат только кэшированные сведения.

Для некоторых операций с элементами, включая GetCurrentPropertyValue и SetFocus, требуется полная ссылка; Попытка выполнить эти действия в элементе, который не имеет никакого значения, приводит к ошибке.

Использование AutomationElementMode_None может быть более эффективным, если требуются только свойства, так как это позволяет избежать дополнительных затрат, связанных с настройкой полных ссылок.

Требования


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

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