AutomationElementMode Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Содержит значения, которые определяют тип ссылки, используемой при возврате элементов UI Automation. Данные значения используются в свойстве AutomationElementMode.
public enum class AutomationElementModepublic enum AutomationElementModetype AutomationElementMode = Public Enum AutomationElementMode- Наследование
Поля
| Full | 1 | Указывает, что возвращаемые элементы имеют полную ссылку на базовый пользовательский интерфейс. |
| None | 0 | Указывает, что возвращаемые элементы не имеют ссылки на базовый пользовательский интерфейс и содержат только кэшированные сведения. Данный режим может использоваться, например, при извлечении имен элементов списка без извлечения ссылок на сами элементы. |
Примеры
В следующем примере показано, как задать режим для CacheRequest.
// 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;
' Set up the request.
Dim cacheRequest As 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 может быть более эффективным, если требуются только свойства, так как позволяет избежать дополнительных затрат, связанных с настройкой полных ссылок.
