UIElement.OnCreateAutomationPeer Método

Definição

Namespace:

Microsoft.UI.Xaml

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

AutomationPeer

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

Exemplos

A totalidade de uma implementação OnCreateAutomationPeer deve consistir em construir a classe par de automação personalizada e retorná-la.

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

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

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.

Consulte 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 OnCreateAutomationPeer implementação não faça nada além de inicializar uma nova instância do seu par de automação personalizado, passando o controle de chamada como proprietário e retornando 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.

Confira também

• AutomationPeer
• Exemplos de código para resolver problemas comuns de acessibilidade programática em aplicativos da área de trabalho do Windows
• Pares de automação personalizados
• Acessibilidade