AutomationPeer.GetNameCore Метод

Определение

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

Microsoft.UI.Xaml.Automation.Peers

Предоставляет поведение однорангового узла, когда клиент Microsoft модель автоматизации пользовательского интерфейса вызывает GetName или эквивалентный API клиента Microsoft модель автоматизации пользовательского интерфейса.

protected:
 virtual Platform::String ^ GetNameCore() = GetNameCore;

winrt::hstring GetNameCore();

protected virtual string GetNameCore();

function getNameCore()

Protected Overridable Function GetNameCore () As String

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

String

Platform::String

winrt::hstring

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

Комментарии

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

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

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

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

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

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