Compartilhar via


UIElement.OnCreateAutomationPeer Método

Definição

Quando implementado em uma classe derivada, retorna implementações AutomationPeer específicas da classe para a infraestrutura de Automação da Interface do Usuário da Microsoft.

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

Retornos

A subclasse AutomationPeer específica da classe a ser retornada.

Exemplos

A totalidade de uma implementação OnCreateAutomationPeer deve consistir na construção da classe par de automação personalizada e na devolução dela.

protected override AutomationPeer OnCreateAutomationPeer() 
{
    return new MediaContainerAP(this, mediaElement); 
}
#include "MediaContainerAP.h"
...
public:
    MyNamespace::MediaContainerAP OnCreateAutomationPeer()
    {
        return winrt::make<MyNamespace::implementation::MediaContainerAP>(*this, mediaElement());
    }
protected:
    virtual AutomationPeer^ OnCreateAutomationPeer() override
    {
        return ref new MediaContainerAP(this, mediaElement);
    }
};
Protected Overrides Function OnCreateAutomationPeer() As AutomationPeer
    Return New MediaContainerAP(Me, mediaElement)
End Function

Comentários

Para obter mais informações sobre a finalidade de um par de automação e por que talvez seja necessário definir uma classe AutomationPeer específica da classe, consulte Pares de automação personalizados.

Você deve substituir esse método em uma classe personalizada em que deseja fornecer um par de automação personalizado para a Automação da Interface do Usuário da Microsoft, em vez do par padrão referenciado pela implementação padrão OnCreateAutomationPeer. A maneira como você define um par personalizado para o controle personalizado depende dos requisitos de acessibilidade do controle, do contrato de interface do usuário e do comportamento dele. Para obter mais informações sobre por que você pode querer definir um novo par, consulte Pares de automação personalizados.

Observação

Este exemplo não é mantido e pode não ser compilado.

Confira Exemplo de acessibilidade XAML para obter uma implementação de OnCreateAutomationPeer que define o par personalizado retornado por OnCreateAutomationPeer (a implementação de par faz parte do Cenário 3 neste exemplo).

Recomendamos que a implementação OnCreateAutomationPeer não faça nada mais do que inicializar uma nova instância do seu par de automação personalizado, passar o controle de chamada como proprietário e retornar essa instância. Não tente lógicas adicionais nesse método. Especificamente, qualquer lógica que possa levar à destruição do AutomationPeer na mesma chamada pode levar a um comportamento de tempo de execução inesperado.

Aplica-se a

Confira também