AutomationElementMode Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Contém valores que especificam o tipo de referência a ser usado ao retornar elementos Automação da Interface do Usuário. Esses valores são usados na propriedade AutomationElementMode.
public enum class AutomationElementModepublic enum AutomationElementModetype AutomationElementMode = Public Enum AutomationElementMode- Herança
Campos
| Nome | Valor | Description |
|---|---|---|
| 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 aos próprios itens. |
| Full | 1 | Especifica que os elementos retornados têm uma referência completa à interface do usuário subjacente. |
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.
O uso de Nenhum pode ser mais eficiente quando apenas as propriedades são necessárias, pois evita a sobrecarga envolvida na configuração de referências completas.
