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 de 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
| 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.