AutomationPeer.GetPatternCore(PatternInterface) Метод

Определение

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

Microsoft.UI.Xaml.Automation.Peers

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

protected:
 virtual Platform::Object ^ GetPatternCore(PatternInterface patternInterface) = GetPatternCore;

IInspectable GetPatternCore(PatternInterface const& patternInterface);

protected virtual object GetPatternCore(PatternInterface patternInterface);

function getPatternCore(patternInterface)

Protected Overridable Function GetPatternCore (patternInterface As PatternInterface) As Object

Параметры

patternInterface

PatternInterface

Значение из перечисления PatternInterface .

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

Object

Platform::Object

IInspectable

Объект , реализующий интерфейс шаблона; значение null , если одноранговый узел не поддерживает этот интерфейс.

Комментарии

Стандартная реализация на уровне AutomationPeer возвращает значение NULL, так как базовый одноранговый класс не поддерживает никаких шаблонов. Большинство существующих одноранговых классов среда выполнения Windows переопределяют этот метод, чтобы сообщить о шаблонах, поддерживаемых определенным одноранговым элементом.

Переопределение этого метода для возврата реализации шаблонов, поддерживаемых одноранговым классом, является одним из наиболее распространенных сценариев реализации однорангового узла автоматизации. См . раздел Пользовательские одноранговые узлы автоматизации.

См. пример специальных возможностей XAML (обратите внимание, что этот пример не поддерживается и может не компилироваться) для реализации OnCreateAutomationPeer , который определяет пользовательский одноранговый узел, возвращаемый OnCreateAutomationPeer (реализация однорангового узла можно найти в сценарии 3 примера).

Работа в Windows 8

Windows 8 поведение выбора однорангового узла потенциально влияет на то, предназначен ли элемент управления для отображения данных в виде элементов. Логика автоматизации для Windows 8 может выбрать выделенный одноранговый узел данных и использовать его шаблоны, даже если для общего элемента управления указан одноранговый узел, который переопределяет GetPatternCore. Например, у вас может быть переопределение ListViewAutomationPeer для шаблонов, но в Windows 8 шаблоны действия для элементов данных могут иметь приоритет, например может использоваться реализация по умолчанию ListViewItemDataAutomationPeer и будет обрабатывать шаблон прокрутки, когда модель автоматизации пользовательского интерфейса ищет шаблоны в элементах. Это отличается, начиная с Windows 8.1. Если в реализации GetPatternCore для общего элемента управления указана поддержка шаблона, эта реализация используется вместо одноранговых элементов данных внутренних элементов.

Если вы переносите код приложения из Windows 8 в Windows 8.1 вам может потребоваться учитывать это изменение поведения, так как это означает, что поддержка шаблонов элементов управления элементами также может использоваться для элементов данных, и, например, может потребоваться добавить поведение для прокрутки элементов.

Приложения, которые скомпилированы для Windows 8, но выполняются в Windows 8.1, продолжают использовать правила, действующие в Windows 8.

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

• FrameworkElementAutomationPeer
• Настраиваемые одноранговые элементы автоматизации
• Шаблоны и интерфейсы элементов управления
• Специальные возможности
• Примеры кода для устранения распространенных проблем с программными специальными возможностями в классических приложениях Windows