AutomationElement.AutomationIdProperty Поле

Определение

Пространство имен:

System.Windows.Automation

Сборка:

UIAutomationClient.dll

Определяет свойство AutomationId, которое используется для определения элементов.

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 

Значение поля

AutomationProperty

Примеры

В следующем примере извлекается текущее значение свойства . Значение по умолчанию возвращается, если элемент не предоставляет его.

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

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

В следующем примере извлекается текущее значение свойства, но указывается, что если сам элемент не предоставляет значение для свойства, NotSupported возвращается вместо значения по умолчанию.

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

Комментарии

Этот идентификатор используется клиентскими приложениями автоматизации пользовательского интерфейса. Поставщики автоматизации пользовательского интерфейса должны использовать эквивалентный идентификатор в AutomationElementIdentifiers.

Это свойство также можно получить из Current свойств или Cached .

Возвращаемые значения свойства имеют тип String. Значением по умолчанию для свойства является пустая строка.

Если он доступен AutomationIdProperty , элемент элемента должен всегда быть одинаковым в любом экземпляре приложения, независимо от локального языка. Значение должно быть уникальным среди элементов того же уровня, но не обязательно уникальным для всего рабочего стола. Например, несколько экземпляров приложения или несколько представлений папок в Microsoft Windows Обозреватель могут содержать элементы с одинаковым AutomationIdProperty, например SystemMenuBar.

Хотя поддержка AutomationId всегда рекомендуется для повышения тестируемости, это свойство не является обязательным. Если она поддерживается, AutomationId она полезна для создания скриптов автоматизации тестирования, которые выполняются независимо от языка пользовательского интерфейса. Клиенты не должны делать никаких предположений относительно объектов , AutomationIdпредоставляемых другими приложениями. Не AutomationId обязательно гарантируется стабильность в разных выпусках или сборках приложения.

Экземпляры элементов пользовательского интерфейса однозначно идентифицируются на рабочем столе по их RuntimeIdProperty свойствам.

Примечание

AutomationIdPropertyподдерживается всеми элементами автоматизации пользовательского интерфейса в представлении элементов управления, за исключением окон приложений верхнего уровня, элементов автоматизации пользовательского интерфейса, производных от элементов управления Windows Presentation Foundation (WPF), не имеющих идентификатора или x:Uid, и элементов автоматизации пользовательского интерфейса, производных от элементов управления Win32, у которых нет идентификатора элемента управления.

См. также раздел

• RuntimeIdProperty
• Общие сведения о свойствах автоматизированного пользовательского интерфейса
• Получение элементов автоматизации пользовательского интерфейса