UIElement.OnCreateAutomationPeer Метод

Определение

Пространство имен:
Microsoft.UI.Xaml
Изменить

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

protected:
 virtual AutomationPeer ^ OnCreateAutomationPeer() = OnCreateAutomationPeer;
AutomationPeer OnCreateAutomationPeer();
protected virtual AutomationPeer OnCreateAutomationPeer();
function onCreateAutomationPeer()
Protected Overridable Function OnCreateAutomationPeer () As AutomationPeer

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

AutomationPeer

Возвращаемый подкласс AutomationPeer для конкретного класса.

Примеры

Вся реализация должна состоять из создания пользовательского OnCreateAutomationPeer однорангового класса автоматизации и возврата его.

protected override AutomationPeer OnCreateAutomationPeer() 
{
    return new MediaContainerAP(this, mediaElement); 
}

#include "MediaContainerAP.h"
...
public:
    MyNamespace::MediaContainerAP OnCreateAutomationPeer()
    {
        return winrt::make<MyNamespace::implementation::MediaContainerAP>(*this, mediaElement());
    }

Комментарии

Дополнительные сведения о назначении однорангового узла автоматизации и о том, почему может потребоваться определить класс AutomationPeer для конкретного класса, см. в разделе "Пользовательские одноранговые узлы автоматизации".

Этот метод следует переопределить в пользовательском классе, где требуется предоставить пользовательский одноранговый узел автоматизации для Microsoft модель автоматизации пользовательского интерфейса, а не одноранговый узел по умолчанию, на который ссылается реализация по умолчаниюOnCreateAutomationPeer. Определение пользовательского однорангового узла для пользовательского элемента управления зависит от требований к специальным возможностям элемента управления, его контракта пользовательского интерфейса и его поведения. Дополнительные сведения о том, почему может потребоваться определить новый одноранговый узел, см. в разделе "Пользовательские одноранговые узлы автоматизации".

Note

Этот пример не поддерживается и может не компилироваться.

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

Рекомендуется, чтобы OnCreateAutomationPeer реализация не делала ничего больше, чем инициализировать новый экземпляр пользовательского однорангового узла автоматизации, передав элемент управления вызовом в качестве владельца и возвращать этот экземпляр. Не пытайтесь выполнять дополнительные логические операции в этом методе. В частности, любая логика, которая может привести к уничтожению AutomationPeer в одном вызове, может привести к неожиданному поведению среды выполнения.

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

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