AutomationPeer.GetPatternCore(PatternInterface) Methode

Definition

Stellt das Verhalten des Peers bereit, wenn ein Microsoft Benutzeroberflächenautomatisierung-Client GetPattern oder eine entsprechende Microsoft Benutzeroberflächenautomatisierung-Client-API aufruft.

protected:
 virtual Platform::Object ^ GetPatternCore(PatternInterface patternInterface) = GetPatternCore;
IInspectable GetPatternCore(PatternInterface const& patternInterface);
protected virtual object GetPatternCore(PatternInterface patternInterface);
function getPatternCore(patternInterface)
Protected Overridable Function GetPatternCore (patternInterface As PatternInterface) As Object

Parameter

patternInterface
PatternInterface

Ein Wert aus der PatternInterface-Enumeration .

Gibt zurück

Object

Platform::Object

IInspectable

Das Objekt, das die Musterschnittstelle implementiert; null , wenn der Peer diese Schnittstelle nicht unterstützt.

Hinweise

Die Standardimplementierung auf AutomationPeer-Ebene gibt NULL zurück, da die grundlegende Peerklasse keine Muster unterstützt. Die Meisten vorhandenen Windows-Runtime Peerklassen überschreiben diese Methode, um die Muster zu melden, die ein bestimmter Peer unterstützt.

Das Überschreiben dieser Methode, um die Implementierung von Mustern zurückzugeben, die ihre Peerklasse unterstützt, ist eines der häufigsten Szenarien für die Implementierung eines Automatisierungspeers. Weitere Informationen finden Sie unter Peers für benutzerdefinierte Automatisierung.

Hinweis

Dieses Beispiel wird nicht beibehalten und möglicherweise nicht kompiliert.

Siehe XAML-Barrierefreiheitsbeispiel für eine Implementierung von OnCreateAutomationPeer , die den von OnCreateAutomationPeer zurückgegebenen benutzerdefinierten Peer definiert (die Peerimplementierung ist Teil von Szenario 3 in diesem Beispiel).

Hinweise zu früheren Versionen

Windows 8.x

Windows 8 Verhalten der Peerauswahl wird möglicherweise dadurch beeinflusst, ob das Steuerelement Daten als Elemente anzeigen soll. Die Automatisierungslogik für Windows 8 kann einen dedizierten Datenpeer auswählen und dessen Muster verwenden, auch wenn ein Peer für das Gesamtsteuerelement angegeben ist und dieser Peer GetPatternCore außer Kraft setzt. Beispielsweise kann die ListViewAutomationPeer-Instanz für Muster überschrieben werden, aber in Windows 8 können die Handlungsmuster für Datenelemente Vorrang haben. Beispielsweise kann die Standardimplementierung von ListViewItemDataAutomationPeer verwendet werden und behandelt das Bildlaufmuster, wenn Benutzeroberflächenautomatisierung nach Mustern in Elementen sucht. Dies unterscheidet sich ab Windows 8.1. Wenn in einer GetPatternCore-Implementierung für das Gesamtsteuerelement eine Musterunterstützung angegeben ist, wird diese Implementierung anstelle interner Elementdaten peers verwendet.

Wenn Sie Ihren App-Code von Windows 8 zu Windows 8.1 migrieren, sollten Sie diese Verhaltensänderung berücksichtigen, da dies bedeutet, dass die Unterstützung der Elementsteuerelementmuster möglicherweise auch für Datenelemente verwendet wird und Sie möglicherweise verhalten für das Scrollen von Elementen hinzufügen müssen, für instance.

Apps, die für Windows 8 kompiliert wurden, aber unter Windows 8.1 ausgeführt werden, weisen weiterhin das Windows 8-Verhalten auf.

Gilt für:

Weitere Informationen