AutomationPeer.GetNameCore Метод

Определение

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

Windows.UI.Xaml.Automation.Peers

Обеспечивает поведение однорангового узла, когда клиент службы автоматизации пользовательского интерфейса Майкрософт вызывает GetName или эквивалентный клиентский API службы автоматизации пользовательского интерфейса Майкрософт.

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

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

Комментарии

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

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

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

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

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

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