AutomationElement.AutomationIdProperty Campo

Definición

Espacio de nombres:

System.Windows.Automation

Ensamblado:

UIAutomationClient.dll

Identifica la propiedad AutomationId, que se usa para identificar los elementos.

public: static initonly System::Windows::Automation::AutomationProperty ^ AutomationIdProperty;

public static readonly System.Windows.Automation.AutomationProperty AutomationIdProperty;

 staticval mutable AutomationIdProperty : System.Windows.Automation.AutomationProperty

Public Shared ReadOnly AutomationIdProperty As AutomationProperty 

Valor de campo

AutomationProperty

Ejemplos

En el ejemplo siguiente se recupera el valor actual de la propiedad . El valor predeterminado se devuelve si el elemento no proporciona uno.

string autoId =
    autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty) as string;

Dim autoId As String = _
    CStr(autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty))

En el ejemplo siguiente se recupera el valor actual de la propiedad , pero se especifica que si el propio elemento no proporciona un valor para la propiedad , NotSupported se devolverá en lugar de un valor predeterminado.

string autoIdString;
object autoIdNoDefault =
    autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty, true);
if (autoIdNoDefault == AutomationElement.NotSupported)
{
    // TODO Handle the case where you do not wish to proceed using the default value.
}
else
{
    autoIdString = autoIdNoDefault as string;
}

Dim autoIdString As String
Dim autoIdNoDefault As Object = autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty, True)
If autoIdNoDefault Is AutomationElement.NotSupported Then
    ' TODO Handle the case where you do not wish to proceed using the default value.
Else
    autoIdString = CStr(autoIdNoDefault)
End If

Comentarios

Las aplicaciones cliente de Automatización de la interfaz de usuario usan este identificador. Los proveedores de automatización de la interfaz de usuario deben usar el identificador equivalente en AutomationElementIdentifiers.

Esta propiedad también se puede recuperar de las Current propiedades o Cached .

Los valores devueltos de la propiedad son de tipo String. El valor predeterminado de la propiedad es una cadena vacía.

Cuando está disponible, se espera que el AutomationIdProperty de un elemento siempre sea el mismo en cualquier instancia de la aplicación, independientemente del idioma local. El valor debe ser único entre los elementos del mismo nivel, pero no necesariamente únicos en todo el escritorio. Por ejemplo, varias instancias de una aplicación o varias vistas de carpeta en el Explorador de Microsoft Windows pueden contener elementos con el mismo AutomationIdProperty, como "SystemMenuBar".

Aunque siempre se recomienda admitir una AutomationId clase para mejorar la capacidad de prueba, esta propiedad no es obligatoria. Cuando se admite, AutomationId resulta útil crear scripts de automatización de pruebas que se ejecutan independientemente del lenguaje de la interfaz de usuario. Los clientes no deben realizar ninguna suposición con respecto a las AutomationIdexpuestas por otras aplicaciones. AutomationId No se garantiza necesariamente que sea estable en distintas versiones o compilaciones de una aplicación.

Las instancias de elementos de la interfaz de usuario (UI) se identifican de forma única en el escritorio por sus RuntimeIdProperty propiedades.

Nota

AutomationIdProperty es compatible con todos los elementos de UI Automation en la vista de control, excepto las ventanas de aplicación de nivel superior, los elementos de UI Automation derivados de los controles de Windows Presentation Foundation (WPF) que no tienen un ID o x:Uid, y los elementos de UI Automation derivados de los controles Win32 que no tienen un ID de control.

Consulte también

• RuntimeIdProperty
• Información general acerca de las propiedades de UI Automation
• Obtener elementos de UI Automation