Erweitern Minimieren

UIElement.OnCreateAutomationPeer Method

Stellt bei einer Implementierung in einer abgeleiteten Klasse klassenspezifische AutomationPeer-Implementierungen für die Automatisierungsinfrastruktur der Microsoft-Benutzeroberfläche bereit.

Syntax


protected virtual AutomationPeer OnCreateAutomationPeer()

Parameter

Methode besitzt keine Parameter.

Rückgabewert

Typ: AutomationPeer

Die klassenspezifische AutomationPeer-Unterklasse, die zurückgegeben werden soll.

Hinweise

Weitere Informationen zum Automatisierungspeer und die Notwendigkeit, eine klassenspezifische AutomationPeer-Klasse zu definieren finden Sie im Artikel zu benutzerdefinierten Automatisierungspeers.

Sie sollten diese Methode in einer benutzerdefinierten Klasse überschreiben, in der Sie einen benutzerdefinierten Automatisierungspeer für Benutzeroberflächenautomatisierung bereitstellen möchten, und nicht den standardmäßigen Peer, der von der Standard-OnCreateAutomationPeer-Implementierung verwiesen wird. Wie Sie einen benutzerdefinierten Peer für das benutzerdefinierte Steuerelement definieren, hängt von den Anforderungen an die Barrierefreiheit, dem Benutzeroberflächenvertrag und dem Verhalten Ihres Steuerelements ab. Weitere Informationen zur Notwendigkeit, einen neuen Peer festzulegen, finden Sie im Artikel zu benutzerdefinierten Automatisierungspeers. Ein Beispiel zum Implementieren von OnCreateAutomationPeer und zum Definieren des benutzerdefinierten Peers, den OnCreateAutomationPeer zurückgibt, finden Sie unter XAML-Barrierefreiheitsbeispiel finden (die Peerimplementierung ist Teil von Szenario 3 in diesem Beispiel).

Es wird empfohlen, dass die OnCreateAutomationPeer-Implementierung nichts weiter tun soll, als eine neue Instanz Ihres benutzerdefinierten Automatisierungspeers zu initialisieren, das aufrufende Steuerelement als Besitzer zu übergeben und diese Instanz zurückzugeben. Versuchen Sie keine zusätzliche Logik in dieser Methode. Insbesondere kann jede Logik, die möglicherweise die Zerstörung von AutomationPeer innerhalb desselben Aufrufs bewirkt, zu unerwartetem Laufzeitverhalten führen.

Beispiele

Die Ganzheit einer OnCreateAutomationPeer Implementierung sollte daraus bestehen, die benutzerdefinierte Automatisierungspeerklasse zu erstellen und sie zurückzugeben.


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

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Namespace

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

Metadaten

Windows.winmd

Siehe auch

UIElement
AutomationPeer
Beispiel für eine XAML-Barrierefreiheit
Benutzerdefinierte Automatisierungspeers
Barrierefreiheit in Windows Store-Apps mit C++, C# oder Visual Basic

 

 

Anzeigen:
© 2015 Microsoft