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.These values are used in the AutomationElementMode property.

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 IUUI subyacente.Specifies that returned elements have a full reference to the underlying IUUI.

None 0

Especifica que los elementos devueltos no tienen ninguna referencia a la IUUI subyacente y sólo contienen información almacenada en memoria caché.Specifies that returned elements have no reference to the underlying IUUI and contain only cached information. 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.This mode might be used, for example, to retrieve the names of items in a list box without obtaining references to the items themselves.

Ejemplos

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

Comentarios

Full es el valor predeterminado y especifica que los elementos devueltos contienen una referencia completa interfaz de usuario (UI)user interface (UI)al subyacente.Full is the default, and specifies that returned elements contain a full reference to the underlying interfaz de usuario (UI)user interface (UI). Ninguno especifica que los elementos devueltos no tienen ninguna referencia a la interfaz de usuario subyacente y contienen solo información almacenada en caché.None specifies that the returned elements have no reference to the underlying UI, and contain only cached information.

Ciertas operaciones en elementos, GetCurrentPropertyValue como o SetFocus, requieren una referencia completa; intentar realizarlos en un elemento que no InvalidOperationExceptiontiene ningún resultado en.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.

El uso de ninguno puede ser más eficaz cuando solo se necesitan propiedades, ya que evita la sobrecarga que implica la configuración de referencias completas.Using None can be more efficient when only properties are needed, as it avoids the overhead involved in setting up full references.

Se aplica a

Consulte también: