AutomationElement.AutomationIdProperty Alan

Tanım

Ad Alanı:

System.Windows.Automation

Bütünleştirilmiş Kod:

UIAutomationClient.dll

AutomationId Öğeleri tanımlamak için kullanılan özelliğini tanımlar.

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 

Alan Değeri

AutomationProperty

Örnekler

Aşağıdaki örnek özelliğin geçerli değerini alır. öğe sağlamazsa varsayılan değer döndürülür.

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

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

Aşağıdaki örnek özelliğin geçerli değerini alır, ancak öğenin kendisi özellik için bir değer sağlamazsa, NotSupported varsayılan değer yerine döndürülmesi gerektiğini belirtir.

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

Açıklamalar

Bu tanımlayıcı UI Otomasyonu istemci uygulamaları tarafından kullanılır. UI Otomasyonu sağlayıcıları içindeki AutomationElementIdentifierseşdeğer tanımlayıcıyı kullanmalıdır.

Bu özellik veya Cached özelliklerinden de alınabilirCurrent.

özelliğinin dönüş değerleri türündedir String. özelliği için varsayılan değer boş bir dizedir.

Kullanılabilir AutomationIdProperty olduğunda, bir öğenin yerel dilden bağımsız olarak uygulamanın herhangi bir örneğinde her zaman aynı olması beklenir. Değerin eşdüzey öğeler arasında benzersiz olması gerekir, ancak tüm masaüstünde benzersiz olması gerekmez. Örneğin, bir uygulamanın birden çok örneği veya Microsoft Windows Gezgini'ndeki birden çok klasör görünümü, "SystemMenuBar" gibi aynı AutomationIdPropertyöğesine sahip öğeler içerebilir.

Daha iyi test edilebilirlik için her zaman bir AutomationId desteği önerilir, ancak bu özellik zorunlu değildir. Desteklendiğinde, AutomationId kullanıcı arabirimi dilinden bağımsız olarak çalışan test otomasyonu betikleri oluşturmak için yararlıdır. İstemciler, diğer uygulamalar tarafından kullanıma sunulanlarla ilgili AutomationIdhiçbir varsayımda bulunmamalıdır. bir AutomationId uygulamanın farklı sürümleri veya derlemeleri arasında kararlı olması garanti edilmez.

Kullanıcı arabirimi (UI) öğelerinin örnekleri, özellikleri tarafından RuntimeIdProperty masaüstünde benzersiz olarak tanımlanır.

Not

AutomationIdProperty, üst düzey uygulama pencereleri, kimliği veya x:Uid olmayan Windows Presentation Foundation (WPF) denetimlerinden türetilen UI Otomasyonu öğeleri ve denetim kimliği olmayan Win32 denetimlerinden türetilen UI Otomasyonu öğeleri dışında denetim görünümündeki tüm UI Otomasyonu öğeleri tarafından desteklenir.

Ayrıca bkz.

• RuntimeIdProperty
• UI Otomasyon Özelliklerine Genel Bakış
• UI Otomasyon Öğelerini Alma