AutomationElement.AutomationIdProperty Campo
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.AutomationPropertyPublic Shared ReadOnly AutomationIdProperty As AutomationProperty Valor de campo
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.
