AutomationElementMode Enumeração
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Contém valores que especificam o tipo de referência a usar ao devolver elementos de Automatização da Interface de Utilizador. Estes valores são usados na AutomationElementMode propriedade.
public enum class AutomationElementModepublic enum AutomationElementModetype AutomationElementMode = Public Enum AutomationElementMode- Herança
Campos
| Name | Valor | Description |
|---|---|---|
| None | 0 | Especifica que os elementos devolvidos não têm referência à interface subjacente e contêm apenas informação em cache. Este modo pode ser usado, por exemplo, para recuperar os nomes dos itens numa caixa de lista sem obter referências aos próprios itens. |
| Full | 1 | Especifica que os elementos retornados têm uma referência completa à interface subjacente. |
Exemplos
O exemplo seguinte mostra como definir o modo num 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
Observações
Full é o padrão e especifica que os elementos retornados contêm uma referência completa à interface de utilizador subjacente (UI). Nenhum especifica que os elementos devolvidos não têm referência à interface subjacente e contêm apenas informação em cache.
Certas operações sobre elementos, como GetCurrentPropertyValue ou SetFocus, requerem uma referência completa; tentar executá-las num elemento que não tem nenhum resulta num InvalidOperationException.
Usar o None pode ser mais eficiente quando só são necessárias propriedades, pois evita a sobrecarga envolvida na criação de referências completas.
