AutomationPeer.GetName Метод

Определение

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

public:
 virtual Platform::String ^ GetName() = GetName;
winrt::hstring GetName();
public string GetName();
function getName()
Public Function GetName () As String

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

String

Platform::String

winrt::hstring

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

Комментарии

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

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

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

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

Применяется к

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