AutomationProperties.NameProperty 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.
Gibt die AutomationProperties.Name angefügte Eigenschaft an. Hierbei handelt es sich um eine Zeichenfolge, die den Namen des Automatisierungselements enthält.
public:
static property DependencyProperty ^ NameProperty { DependencyProperty ^ get(); };static DependencyProperty NameProperty();public static DependencyProperty NameProperty { get; }var dependencyProperty = AutomationProperties.nameProperty;Public Shared ReadOnly Property NameProperty As DependencyPropertyEigenschaftswert
Der Bezeichner für die angefügte AutomationProperties.Name-Eigenschaft .
Hinweise
Die Name-Eigenschaft sollte mit dem Beschriftungstext auf dem Bildschirm identisch sein. Name sollte beispielsweise "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 Textpräsentation der Benutzeroberfläche unterstrichen wird. Außerdem sollte die Name-Eigenschaft keine erweiterte oder geänderte Version der Beschriftung auf dem Bildschirm 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. Der alternative Text sollte keine detaillierte Beschreibung der visuellen Details sein, sondern eine präzise Beschreibung der Ui-Funktion oder des Features, als wäre er durch einfachen Text gekennzeichnet. Beispielsweise heißt die Windows-Startmenüschaltfläche "Start" (Schaltfläche) statt "Windows-Logo auf blauer runder Kugelgrafik" (Schaltfläche). Weitere Informationen finden Sie unter Erstellen von Textäquivalenten für Bilder.
Wenn eine Benutzeroberfläche 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 Benutzeroberfläche wird jedoch aufgrund von Lokalisierungs- und Barrierefreiheitsproblemen abgeraten.
Die Name-Eigenschaft darf keine Steuerelementrolle oder -typinformationen wie "button" oder "list" enthalten. Andernfalls wird es mit dem Text aus der LocalizedControlType-Eigenschaft in Konflikt treten, wenn diese beiden Eigenschaften angefügt werden (viele vorhandene Hilfstechnologien tun dies).
Die Name-Eigenschaft kann nicht als eindeutiger Bezeichner unter geschwistern verwendet werden. Solange er jedoch mit der Ui-Präsentation konsistent ist, kann derselbe Name-Wert unter Peers unterstützt werden. Zur Testautomatisierung sollten die Clients die Verwendung der AutomationId - oder RuntimeId-Eigenschaft in Betracht ziehen.
Bei Textsteuerelementen muss die Name-Eigenschaft nicht immer mit dem text identisch sein, der im Steuerelement angezeigt wird, solange das Textmuster auch unterstützt wird.