AutomationElement.AutomationIdProperty Champ

  • Référence

Définition

Espace de noms:
System.Windows.Automation
Assembly:
UIAutomationClient.dll

Identifie la propriété AutomationId, qui est utilisée pour identifier des éléments.

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

Valeur de champ

AutomationProperty

Exemples

L’exemple suivant récupère la valeur actuelle de la propriété. La valeur par défaut est retournée si l’élément n’en fournit pas.

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

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

L’exemple suivant récupère la valeur actuelle de la propriété, mais spécifie que si l’élément lui-même ne fournit pas de valeur pour la propriété, NotSupported doit être retourné au lieu d’une valeur par défaut.

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

Remarques

Cet identificateur est utilisé par les applications clientes UI Automation. Les fournisseurs UI Automation doivent utiliser l’identificateur équivalent dans AutomationElementIdentifiers.

Cette propriété peut également être récupérée à partir des Current propriétés ou Cached .

Les valeurs de retour de la propriété sont de type String. La valeur par défaut de la propriété est une chaîne vide.

Lorsqu’il est disponible, le AutomationIdProperty d’un élément est censé toujours être le même dans n’importe quel instance de l’application, quelle que soit la langue locale. La valeur doit être unique parmi les éléments frères, mais pas nécessairement unique sur l’ensemble du bureau. Par exemple, plusieurs instances d’une application, ou plusieurs affichages de dossiers dans Microsoft Windows Explorer, peuvent contenir des éléments avec le même AutomationIdProperty, comme « SystemMenuBar ».

Bien que la prise en charge d’un AutomationId soit toujours recommandée pour une meilleure testabilité, cette propriété n’est pas obligatoire. Lorsqu’il est pris en charge, un est utile pour créer des AutomationId scripts d’automatisation de test qui s’exécutent quel que soit le langage de l’interface utilisateur. Les clients ne doivent faire aucune hypothèse concernant les AutomationIdéléments exposés par d’autres applications. Il AutomationId n’est pas nécessairement garanti qu’il soit stable dans différentes versions ou builds d’une application.

Les instances d’éléments d’interface utilisateur sont identifiées de manière unique sur le bureau par leurs RuntimeIdProperty propriétés.

Notes

AutomationIdProperty est pris en charge par tous les éléments UI Automation dans l’affichage de contrôle, à l’exception des fenêtres d’application de niveau supérieur, des éléments UI Automation dérivés des contrôles Windows Presentation Foundation (WPF) n’ayant pas d’ID ou de x:Uid, et des éléments UI Automation dérivés des contrôles Win32 n’ayant pas d’ID de contrôle.

S’applique à

Voir aussi