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

Определение

Содержит значения, которые определяют тип ссылки, используемой при возврате элементов UI Automation.Contains values that specify the type of reference to use when returning UI Automation elements. Данные значения используются в свойстве AutomationElementMode.These values are used in the AutomationElementMode property.

public enum class AutomationElementMode
public enum AutomationElementMode
type AutomationElementMode = 
Public Enum AutomationElementMode
Наследование
AutomationElementMode

Поля

Full 1

Указывает, что возвращаемые элементы имеют полную ссылку на базовый пользовательский интерфейс.Specifies that returned elements have a full reference to the underlying UI.

None 0

Указывает, что возвращаемые элементы не имеют ссылки на базовый пользовательский интерфейс и содержат только кэшированные данные.Specifies that returned elements have no reference to the underlying UI and contain only cached information. Данный режим может использоваться, например, при извлечении имен элементов списка без извлечения ссылок на сами элементы.This mode might be used, for example, to retrieve the names of items in a list box without obtaining references to the items themselves.

Примеры

В следующем примере показано, как задать режим для CacheRequest .The following example shows how to set the mode on a 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 является значением по умолчанию и указывает, что возвращаемые элементы содержат полную ссылку на базовый пользовательский интерфейс.Full is the default, and specifies that returned elements contain a full reference to the underlying user interface (UI). None указывает, что возвращаемые элементы не имеют ссылки на базовый пользовательский интерфейс и содержат только кэшированные данные.None specifies that the returned elements have no reference to the underlying UI, and contain only cached information.

Для некоторых операций с элементами, например GetCurrentPropertyValue или SetFocus , требуется полная ссылка; попытка выполнить их для элемента, который не имеет результата InvalidOperationException .Certain operations on elements, such as GetCurrentPropertyValue or SetFocus, require a full reference; attempting to perform these on an element that has none results in an InvalidOperationException.

Использование параметра "нет" может быть более эффективным, если требуются только свойства, так как это позволяет избежать издержек, связанных с настройкой полных ссылок.Using None can be more efficient when only properties are needed, as it avoids the overhead involved in setting up full references.

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

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