Прочитать на английском

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

AutomationElementMode Перечисление

  • Ссылка

Определение

Пространство имен:
System.Windows.Automation
Сборка:
UIAutomationClient.dll

Содержит значения, которые определяют тип ссылки, используемой при возврате элементов UI Automation. Данные значения используются в свойстве AutomationElementMode.

C# 
public enum AutomationElementMode
Наследование
Object
ValueType
Enum
AutomationElementMode

Поля

Имя Значение Описание
Full 1

Указывает, что возвращаемые элементы имеют полную ссылку на базовый пользовательский интерфейс.
None 0

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

Примеры

В следующем примере показано, как задать режим для CacheRequest.

C# 
// Set up the request.
CacheRequest cacheRequest = new CacheRequest();

// Do not get a full reference to the cached objects, only to their cached properties and patterns.
cacheRequest.AutomationElementMode = AutomationElementMode.None;

Комментарии

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

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

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

Применяется к

Продукт Версии
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

См. также раздел