AutomationPeer.GetName Метод

Определение

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

Microsoft.UI.Xaml.Automation.Peers

Получает текст, который описывает элемент, связанный с данным одноранговым элементом автоматизации. Значение Microsoft модель автоматизации пользовательского интерфейса Name — это основной идентификатор, используемый большинством специальных возможностей, когда они представляют пользовательский интерфейс приложения путем взаимодействия с платформой Microsoft модель автоматизации пользовательского интерфейса.

public:
 virtual Platform::String ^ GetName() = GetName;

winrt::hstring GetName();

public string GetName();

function getName()

Public Function GetName () As String

Возвращаемое значение

String

Platform::String

winrt::hstring

Имя элемента, являющегося владельцем однорангового узла, используемое вспомогательными технологиями и другими клиентами Microsoft модель автоматизации пользовательского интерфейса.

Комментарии

FrameworkElementAutomationPeer вводит поведение GetName, предоставляя промежуточную реализацию GetNameCore . Если элемент имеет значение для свойства LabeledByMicrosoft модель автоматизации пользовательского интерфейса, в качестве name используется значение Name элемента метки.

FrameworkElementAutomationPeer также вводит поведение через внутренний метод GetPlainText , который могут переопределять другие одноранговые классы по умолчанию, чтобы получить доступ к модели содержимого этого элемента управления и вернуть полезное значение по умолчанию для Name. Например, любой производный класс ContentControl будет использовать строковое представление своего значения Content в качестве имени по умолчанию. Это включено, так как внутренне ContentControl реализует GetPlainText и привнося такое поведение всем производным классам ContentControl . Таким образом вы получите полезное имя по умолчанию из строкового значения кнопки, например.

Другие конкретные одноранговые узлы также могут иметь промежуточную реализацию GetNameCore, которая предоставляет удобный способ предоставления встроенных значений для name для конкретного элемента управления среда выполнения Windows. Источником этих значений являются другие свойства пользовательского интерфейса, которые обычно задаются в XAML или в виде пользовательского кода приложения. Например, TextBoxAutomationPeer реализует поведение, которое использует значение свойства Text из владельца TextBox в качестве имени по умолчанию. С точки зрения пользовательского кода поведение по умолчанию можно переопределить, применив другое значение AutomationProperties.Name . С точки зрения однорангового исполнителя или поставщика поведение однорангового узла по умолчанию можно изменить, наследуя новый одноранговый класс от существующего однорангового узла, переопределяя GetNameCore и предоставляя ему новую реализацию, которая не будет вызывать базовую реализацию по крайней мере в некоторых случаях.

Дополнительные сведения о возможном поведении по умолчанию определенных одноранговых классов для элементов управления среда выполнения Windows по умолчанию см. в справочном разделе для этого класса одноранговых узлов и найдите примечания о реализации в разделе Примечания.

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

• Настраиваемые одноранговые элементы автоматизации