Udostępnij za pośrednictwem

AutomationElement.AutomationIdProperty Pole

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Automation
Zestaw:
UIAutomationClient.dll

AutomationId Identyfikuje właściwość , która służy do identyfikowania elementów.

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

Wartość pola

AutomationProperty

Przykłady

Poniższy przykład pobiera bieżącą wartość właściwości . Wartość domyślna jest zwracana, jeśli element go nie podaje.

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

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

Poniższy przykład pobiera bieżącą wartość właściwości, ale określa, że jeśli sam element nie podaje wartości właściwości, NotSupported ma zostać zwrócony zamiast wartości domyślnej.

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

Uwagi

Ten identyfikator jest używany przez aplikacje klienckie automatyzacja interfejsu użytkownika. automatyzacja interfejsu użytkownika dostawcy powinni używać równoważnego identyfikatora w elemencie AutomationElementIdentifiers.

Tę właściwość można również pobrać z Current właściwości lub Cached .

Zwracane wartości właściwości są typu String. Wartość domyślna właściwości to pusty ciąg.

Jeśli element jest dostępny AutomationIdProperty , powinien być zawsze taki sam w każdym wystąpieniu aplikacji, niezależnie od języka lokalnego. Wartość powinna być unikatowa wśród elementów równorzędnych, ale nie musi być unikatowa na całym pulpicie. Na przykład wiele wystąpień aplikacji lub wielu widoków folderów w Eksploratorze Microsoft Windows może zawierać elementy z tymi samymi AutomationIdPropertyelementami, takimi jak "SystemMenuBar".

Chociaż obsługa elementu AutomationId jest zawsze zalecana w celu zapewnienia lepszej możliwości testowania, ta właściwość nie jest obowiązkowa. Jeśli jest obsługiwana, funkcja jest przydatna AutomationId do tworzenia skryptów automatyzacji testów uruchamianych niezależnie od języka interfejsu użytkownika. Klienci nie powinni podejmować żadnych założeń dotyczących AutomationIdobiektów udostępnianych przez inne aplikacje. Element AutomationId nie musi być stabilny w różnych wersjach lub kompilacjach aplikacji.

Wystąpienia elementów interfejsu użytkownika (UI) są jednoznacznie identyfikowane na pulpicie przez ich RuntimeIdProperty właściwości.

Uwaga

AutomationIdPropertyjest obsługiwany przez wszystkie elementy automatyzacja interfejsu użytkownika w widoku sterowania z wyjątkiem okien aplikacji najwyższego poziomu, automatyzacja interfejsu użytkownika elementów pochodzących z kontrolek Windows Presentation Foundation (WPF), które nie mają identyfikatora lub x:Uid, i automatyzacja interfejsu użytkownika elementów pochodzących z kontrolek Win32, które nie mają identyfikatora kontrolki.

Dotyczy

Zobacz też