AutomationElementMode Enumerazione

Definizione

Contiene valori che specificano il tipo di riferimento da usare in caso di restituzione degli elementi di automazione interfaccia utente. Questi valori vengono utilizzati nella proprietà AutomationElementMode.These values are used in the AutomationElementMode property.

public enum class AutomationElementMode
public enum AutomationElementMode
type AutomationElementMode = 
Public Enum AutomationElementMode
Ereditarietà
AutomationElementMode

Campi

Full 1

Specifica che gli elementi restituiti presentano un riferimento completo all'Interfaccia utenteUI sottostante.Specifies that returned elements have a full reference to the underlying Interfaccia utenteUI.

None 0

Specifica che gli elementi restituiti non presentano riferimenti all'Interfaccia utenteUI sottostante e contengono solo informazioni memorizzate nella cache.Specifies that returned elements have no reference to the underlying Interfaccia utenteUI and contain only cached information. Questa modalità potrebbe essere utilizzata, ad esempio, per recuperare i nomi di elementi in una casella di riepilogo senza ottenere riferimenti agli elementi stessi.This mode might be used, for example, to retrieve the names of items in a list box without obtaining references to the items themselves.

Esempi

Nell'esempio seguente viene illustrato come impostare la modalità in un CacheRequestoggetto.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

Commenti

Full è l'impostazione predefinita e specifica che gli elementi restituiti contengono un riferimento completo all'oggetto interfaccia utenteuser interface (UI)sottostante.Full is the default, and specifies that returned elements contain a full reference to the underlying interfaccia utenteuser interface (UI). None specifica che gli elementi restituiti non hanno alcun riferimento all'interfaccia utente sottostante e contengono solo le informazioni memorizzate nella cache.None specifies that the returned elements have no reference to the underlying UI, and contain only cached information.

Per alcune operazioni sugli elementi, ad GetCurrentPropertyValue esempio SetFocuso, è necessario un riferimento completo. il tentativo di eseguire tali operazioni su un elemento che non ha InvalidOperationExceptionalcun risultato in un oggetto.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.

L'uso di None può essere più efficiente quando sono necessarie solo le proprietà, in quanto evita l'overhead richiesto per la configurazione di riferimenti completi.Using None can be more efficient when only properties are needed, as it avoids the overhead involved in setting up full references.

Si applica a

Vedi anche