Compartir a través de


AutomationElementMode Enumeración

Definición

Contiene valores que especifican el tipo de referencia que se usa al devolver elementos de automatización de la interfaz de usuario. Estos valores se utilizan en la propiedad AutomationElementMode.

public enum class AutomationElementMode
public enum AutomationElementMode
type AutomationElementMode = 
Public Enum AutomationElementMode
Herencia
AutomationElementMode

Campos

Full 1

Especifica que los elementos devueltos tienen una referencia completa a la interfaz de usuario subyacente.

None 0

Especifica que los elementos devueltos no tienen ninguna referencia a la interfaz de usuario subyacente y solo contienen información almacenada en caché. Por ejemplo, este modo podría utilizarse para recuperar los nombres de elementos en un cuadro de lista sin obtener referencias a los propios elementos.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer el modo en .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

Comentarios

Full es el valor predeterminado y especifica que los elementos devueltos contienen una referencia completa a la interfaz de usuario (UI) subyacente. None especifica que los elementos devueltos no tienen ninguna referencia a la interfaz de usuario subyacente y solo contienen información almacenada en caché.

Ciertas operaciones en elementos, como GetCurrentPropertyValue o SetFocus, requieren una referencia completa; al intentar realizarlas en un elemento que no tiene ninguno, se produce una InvalidOperationExceptionexcepción .

El uso de None puede ser más eficaz cuando solo se necesitan propiedades, ya que evita la sobrecarga implicada en la configuración de referencias completas.

Se aplica a

Consulte también