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 Benutzeroberflächenautomatisierung-Client GetName oder eine entsprechende Microsoft Benutzeroberflächenautomatisierung-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ächenautomatisierung-Clients verwendet wird.
Hinweise
FrameworkElementAutomationPeer führt das Verhalten in GetName ein, indem es eine zwischengeschaltete GetNameCore-Implementierung bereitstellt. Wenn ein Element über einen Wert für die Eigenschaft LabeledByMicrosoft Benutzeroberflächenautomatisierung 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 Standard-Peerklassen möglicherweise außer Kraft gesetzt wird, 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 allen von ContentControl abgeleiteten Klassen vermittelt. So erhalten Sie beispielsweise 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, 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, GetNameCore außer Kraft gesetzt und eine neue Implementierung bereitgestellt wird, die die Basisimplementierung in mindestens einigen Fällen nicht aufruft.
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.