AutomationPeer.GetNameCore Methode
Definition
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.
Stellt das Verhalten des Peers bereit, wenn ein Microsoft UI Automation-Client GetName oder eine entsprechende Microsoft UI Automation-Client-API aufruft.
protected:
virtual Platform::String ^ GetNameCore() = GetNameCore;winrt::hstring GetNameCore();protected virtual string GetNameCore();function getNameCore()Protected Overridable Function GetNameCore () As StringGibt zurück
Der Name, der von Hilfstechnologien und anderen Microsoft-Benutzeroberflächenautomatisierungsclients verwendet wird.
Hinweise
FrameworkElementAutomationPeer führt das Verhalten in GetName ein, indem eine zwischengeschaltete GetNameCore-Implementierung bereitgestellt wird. Wenn ein Element über einen Wert für die LabeledByMicrosoft UI Automation-Eigenschaft verfügt, wird der Name-Wert des Bezeichnungselements als Name verwendet.
FrameworkElementAutomationPeer führt auch das Verhalten über eine interne GetPlainText-Methode ein, die von anderen Standardpeerklassen überschrieben werden kann, um auf das Inhaltsmodell dieses Steuerelements zuzugreifen und einen nützlichen Standardwert für Name zurückzugeben. Beispielsweise verwendet jede von ContentControl abgeleitete Klasse eine Zeichenfolgendarstellung ihres Content-Werts als Standardname. Dies ist aktiviert, da ContentControl intern GetPlainText implementiert und dieses Verhalten an alle von ContentControl abgeleiteten Klassen weitergibt. So erhalten Sie z. B. einen nützlichen Namensstandard aus dem Zeichenfolgenwert einer Schaltfläche.
Andere spezifische Peers können auch über eine zwischengeschaltete GetNameCore-Implementierung verfügen, die eine nützliche Möglichkeit für dieses bestimmte Windows-Runtime-Steuerelement bietet, um integrierte Werte für Name bereitzustellen. Die Quelle dieser Werte stammt aus anderen UI-Eigenschaften, die in der Regel in XAML oder als App-Benutzercode festgelegt werden. Beispielsweise implementiert TextBoxAutomationPeer verhalten, das den Wert der Text-Eigenschaft des Besitzers TextBox als Standardname verwendet. Aus Sicht des Benutzercodes kann das Standardverhalten überschrieben werden, indem ein anderer AutomationProperties.Name-Wert angewendet wird. Aus Sicht des Peerimplementierungs-/Anbieters kann das Standardverhalten des Peers geändert werden, indem eine neue Peerklasse vom vorhandenen Peer abgeleitet wird, GetNameCore überschrieben und eine neue Implementierung bereitgestellt wird, die die Basisimplementierung zumindest in einigen Fällen nicht aufrufen würde.
Weitere Informationen zum möglichen Standardverhalten bestimmter Peerklassen für Standardsteuerelemente Windows-Runtime finden Sie im Referenzthema für diese bestimmte Peerklasse, und suchen Sie im Abschnitt Hinweise zur Implementierung.