UIElement.OnCreateAutomationPeer Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 AutomationPeerRetornos
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.