AutomationPeer.GetName 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.
Ruft den Text ab, der das Element beschreibt, das diesem Automatisierungspeer zugeordnet ist. Der Wert Microsoft UI Automation Name ist der primäre Bezeichner, der von den meisten Hilfstechnologien verwendet wird, wenn sie die Benutzeroberfläche Ihrer App darstellen, indem sie mit dem Microsoft UI Automation-Framework interagieren.
public:
virtual Platform::String ^ GetName() = GetName;winrt::hstring GetName();public string GetName();function getName()Public Function GetName () As StringGibt zurück
Der Name des Elements, das der Besitzer des Peers ist, wie er von Hilfstechnologien und anderen Microsoft UI Automation-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 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 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.