Sdílet prostřednictvím

AutomationElement.AutomationIdProperty Pole

  • Reference

Definice

Obor názvů:
System.Windows.Automation
Sestavení:
UIAutomationClient.dll

Identifikuje AutomationId vlastnost, která se používá k identifikaci prvků.

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

Hodnota pole

AutomationProperty

Příklady

Následující příklad načte aktuální hodnotu vlastnosti. Výchozí hodnota je vrácena, pokud prvek neposkytuje.

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

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

Následující příklad načte aktuální hodnotu vlastnosti, ale určuje, že pokud samotný prvek neposkytuje hodnotu pro vlastnost, NotSupported má být vrácen místo výchozí hodnoty.

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

Poznámky

Tento identifikátor používají klientské aplikace automatizace uživatelského rozhraní. Zprostředkovatelé automatizace uživatelského rozhraní by měli používat ekvivalentní identifikátor v nástroji AutomationElementIdentifiers.

Tuto vlastnost lze také načíst z Current vlastností nebo Cached .

Návratové hodnoty vlastnosti jsou typu String. Výchozí hodnota vlastnosti je prázdný řetězec.

Pokud je prvek k dispozici AutomationIdProperty , očekává se, že bude vždy stejný v libovolné instanci aplikace bez ohledu na místní jazyk. Hodnota by měla být jedinečná mezi elementy na stejné ploše, ale nemusí být nutně jedinečná na celé ploše. Například více instancí aplikace nebo více zobrazení složek v Průzkumníku Windows může obsahovat prvky se stejným AutomationIdProperty, jako je například SystemMenuBar.

I když se pro lepší testovatelnost vždy doporučuje podporovat AutomationId , není tato vlastnost povinná. Tam, kde se podporuje, AutomationId je užitečný pro vytváření skriptů pro automatizaci testů, které běží bez ohledu na jazyk uživatelského rozhraní. Klienti by neměli provádět žádné předpoklady týkající se AutomationIdobjektů vystavených jinými aplikacemi. Nemusí AutomationId být nutně zaručeno, že bude stabilní v různých verzích nebo buildech aplikace.

Instance prvků uživatelského rozhraní (UI) jsou na ploše jednoznačně identifikovány jejich RuntimeIdProperty vlastnostmi.

Poznámka

AutomationIdPropertyje podporován všemi prvky automatizace uživatelského rozhraní v zobrazení ovládacích prvků s výjimkou oken aplikací nejvyšší úrovně, prvků automatizace uživatelského rozhraní odvozených z ovládacích prvků Windows Presentation Foundation (WPF), které nemají ID nebo x:Uid, a prvky automatizace uživatelského rozhraní odvozené z ovládacích prvků Win32, které nemají ID ovládacího prvku.

Platí pro

Viz také