AutomationProperties.Name Angefügte Eigenschaft
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 Benutzeroberflächenautomatisierung Namen des Elements ab oder legt diese fest.
see GetName, and SetNamesee GetName, and SetNamesee GetName, and SetNameHinweise
Die Name -Eigenschaft sollte mit dem Bezeichnungstext auf dem Bildschirm identisch sein. Beispielsweise Name sollte "Durchsuchen" für ein Schaltflächenelement mit der Bezeichnung "Durchsuchen" sein. Die Name -Eigenschaft darf nicht das mnemonische Zeichen für die Zugriffsschlüssel (d. h. "&") enthalten, das in der Textdarstellung der Benutzeroberfläche unterstrichen wird. Außerdem sollte die Name Eigenschaft keine erweiterte oder geänderte Version der Bildschirmbezeichnung sein, da die Inkonsistenz zwischen dem Namen und der Bezeichnung zu Verwirrung bei Clientanwendungen und Benutzern führen kann.
Wenn der entsprechende Bezeichnungstext auf dem Bildschirm nicht sichtbar ist oder durch Grafiken ersetzt wird, sollte alternativer Text ausgewählt werden. Der alternative Text sollte prägnant, intuitiv und auf die Benutzeroberflächensprache der Anwendung oder auf die Standardsprache der Benutzeroberfläche des Betriebssystems lokalisiert sein. Bei dem alternativen Text sollte es sich nicht um eine detaillierte Beschreibung der visuellen Details handeln, sondern um eine präzise Beschreibung der Ui-Funktion oder des Features, als ob sie mit einfachem Text beschriftet wäre. Die Windows-Startmenüschaltfläche heißt z. B. "Start" (Schaltfläche) anstelle von "Windows-Logo auf blauer runder Kugelgrafik" (Schaltfläche). Weitere Informationen finden Sie unter Erstellen von Textäquivalenten für Bilder.
Wenn eine Ui-Bezeichnung Textgrafiken verwendet (z. B. die Verwendung von ">>" für eine Schaltfläche, die ein Element von links nach rechts hinzufügt), sollte die Name Eigenschaft durch eine geeignete Textalternative überschrieben werden (z. B. "Hinzufügen"). Die Verwendung von Textgrafiken als Ui-Bezeichnung wird jedoch aufgrund von Lokalisierungs- und Barrierefreiheitsproblemen abgeraten.
Die Name Eigenschaft darf keine Informationen zur Steuerelementrolle oder zum Typ enthalten, z. B. "button" oder "list". Andernfalls tritt ein Konflikt mit dem Text der LocalizedControlType-Eigenschaft auf, wenn diese beiden Eigenschaften angefügt werden (viele vorhandene Hilfstechnologien tun dies).
Die Name -Eigenschaft kann nicht als eindeutiger Bezeichner unter gleichgeordneten Elementen verwendet werden. Solange es jedoch mit der Ui-Präsentation konsistent ist, kann der gleiche Name Wert unter Peers unterstützt werden. Für die Testautomatisierung sollten die Clients die Verwendung der AutomationId - oder RuntimeId-Eigenschaft in Betracht ziehen.
Textsteuerelemente müssen nicht immer identisch mit dem Name Text sein, der innerhalb des Steuerelements angezeigt wird, solange das Textmuster ebenfalls unterstützt wird.
Von den verschiedenen angefügten Eigenschaften ist Namewahrscheinlich die wichtigste . Dies liegt daran, dass es die Eigenschaft ist, auf die Name am häufigsten zugegriffen und von Hilfstechnologien gemeldet wird, wenn Benutzer in einem Barrierefreiheitsszenario mit einer App interagieren. Dient Name als lesbarer Bezeichner für das UI-Element.
Verschiedene UI-Elemente verfügen über Peerweiterleitung, die basierend auf anderen Elementeigenschaften einen Standardwert Name bereitstellen kann. Beispielsweise leitet die Peerweiterleitung für die Button-Klasse die ToString Auswertung des Button-Inhalts weiter und verwendet diese Zeichenfolge als Standard Name. Legen Sie die angefügte Eigenschaft für dieses Element in XAML fest, um diese Standardeinstellung außer Kraft zu setzen oder auf andere Weise einen Name Wert für alle Benutzeroberflächenelemente bereitzustellen, Name in denen kein Microsoft-Benutzeroberflächenautomatisierung Name verfügbar ist. Weitere Informationen dazu, warum ein Microsoft Benutzeroberflächenautomatisierung Name wichtig ist, finden Sie unter Grundlegende Informationen zur Barrierefreiheit. Weitere Informationen dazu, wie Sie testen können, ob ein Element bereits über eine von Peer bereitgestellte Name , die nützlich ist, finden Sie unter Testen der Barrierefreiheit.
Aus Lokalisierungsgründen sollten Sie hartcodierte Zeichenfolgenwerte für den Name in XAML vermeiden. Wenn Sie die x:Uid-Direktive für das Element festlegen, können Sie RESW-Ressourcen verwenden, um die Eigenschaft als Ziel festzulegen und unterschiedliche Werte für die Lokalisierung bereitzustellen. Für angefügte Eigenschaften erfordert das Formular "Ressourcenbezeichner" eine vollständige Qualifizierung der angefügten Eigenschaft im XAML-Format, einschließlich ihres Namespaces und eines using:-Präfixes. Wenn Sie beispielsweise den wert der AutomationProperties.Name angefügten Eigenschaft auf eine Ressource mit dem x:Uid-Direktivenwert "sendButton" festlegen möchten, lautet der Name Wert des Datenelements in den RESW-Ressourcen. sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name
- Type: string
- Bezeichnerfeld: NameProperty
- Accessormethoden: GetName, SetName