AutomationPeer.GetPatternCore(PatternInterface) Methode

Referenz

Definition

Namespace:: Microsoft.UI.Xaml.Automation.Peers

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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.

Eine Implementierung von OnCreateAutomationPeer, die den von OnCreateAutomationPeer zurückgegebenen benutzerdefinierten Peer definiert, finden Sie im XAML-Barrierefreiheitsbeispiel (beachten Sie, dass dieses Beispiel nicht beibehalten wird und möglicherweise nicht kompiliert wird).

Windows 8-Verhaltensweise

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:

Freigeben über