Partilhar via


AutomationElementMode Enumeração

Definição

Contém valores que especificam o tipo de referência a ser usado ao retornar elementos de Automação da Interface do Usuário. Esses valores são usados na propriedade AutomationElementMode.

public enum class AutomationElementMode
public enum AutomationElementMode
type AutomationElementMode = 
Public Enum AutomationElementMode
Herança
AutomationElementMode

Campos

Full 1

Especifica que os elementos retornados têm uma referência completa à interface do usuário subjacente.

None 0

Especifica que os elementos retornados não têm referência à interface do usuário subjacente e contêm apenas informações armazenadas em cache. Esse modo pode ser usado, por exemplo, para recuperar os nomes dos itens em uma caixa de listagem sem obter referências para os itens em si.

Exemplos

O exemplo a seguir mostra como definir o modo em um 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

Comentários

Full é o padrão e especifica que os elementos retornados contêm uma referência completa à interface do usuário (interface do usuário) subjacente. Nenhum especifica que os elementos retornados não têm referência à interface do usuário subjacente e contêm apenas informações armazenadas em cache.

Determinadas operações em elementos, como GetCurrentPropertyValue ou SetFocus, exigem uma referência completa; tentar executá-las em um elemento que não tenha nenhum resultado em um InvalidOperationException.

Usar Nenhum pode ser mais eficiente quando apenas propriedades são necessárias, pois evita a sobrecarga envolvida na configuração de referências completas.

Aplica-se a

Confira também