OnCreateAutomationPeer, méthode
TOC
Réduire la table des matières
Développer la table des matières

UIElement.OnCreateAutomationPeer Method

En cas d'implémentation dans une classe dérivée, retourne les implémentations AutomationPeer spécifiques à la classe pour l'infrastructure Microsoft UI Automation.

Syntaxe


protected virtual AutomationPeer OnCreateAutomationPeer()

Paramètres

Ce Méthode ne possède pas de paramètres.

Valeur de retour

Type: AutomationPeer

La sous-classe AutomationPeer spécifique à la classe à retourner.

Remarques

Pour plus d'informations sur l'objectif d'un homologue Automation et sur la raison qui justifie la définition d'une classe AutomationPeer spécifique à la classe, consultez Homologues d’automation personnalisés.

Vous devez substituer cette méthode dans une classe personnalisée où vous souhaitez fournir un homologue Automation personnalisé pour l'UI Automation, plutôt que l'homologue par défaut référencé par l'implémentation OnCreateAutomationPeer par défaut. Le mode de définition d'un homologue personnalisé pour votre contrôle personnalisé dépend des spécifications d'accessibilité de votre contrôle, de son contrat d'interface utilisateur et de son comportement. Pour plus d'informations sur la raison pour laquelle vous souhaitez définir un nouvel homologue, consultez Homologues d’automation personnalisés. Pour obtenir un exemple qui implémente OnCreateAutomationPeer et définit l'homologue personnalisé que retourne OnCreateAutomationPeer , consultez l'exemple d'accessibilité XAML (l'implémentation homologue fait partie du scénario 3 dans cet exemple).

Nous vous recommandons que l'implémentation OnCreateAutomationPeer ne doit rien faire de plus que d'initialiser une nouvelle instance de votre homologue Automation personnalisé en passant le contrôle appelant comme propriétaire et de retourner cette instance. N'essayez pas de logique supplémentaire dans cette méthode. En particulier, une logique susceptible d'entraîner la destruction d'AutomationPeer dans le même appel peut provoquer un comportement inattendu au moment de l'exécution.

Exemples

L'intégralité d'une implémentation OnCreateAutomationPeer doit consister à construire la classe homologue d'automatisation personnalisée et à la retourner.


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

Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Métadonnées

Windows.winmd

Voir aussi

UIElement
AutomationPeer
Exemple d'accessibilité XAML
Homologues Automation personnalisés
Accessibilité dans les applications Windows Store à l'aide des langages C++, C# ou Visual Basic

 

 

Afficher:
© 2017 Microsoft