Eigenschaftsbezeichner des Automation-Elements
In diesem Thema werden die benannten Konstanten beschrieben, die die Eigenschaften von Microsoft UI Automation-Elementen identifizieren.
| Konstante/Wert | BESCHREIBUNG |
|---|---|
|
Gibt die AcceleratorKey-Eigenschaft an, bei der es sich um eine Zeichenfolge handelt, die die Tastenkombinationen (auch Tastenkombination genannt) für das Automation-Element enthält. Tastenkombinationen rufen eine Aktion auf. Beispielsweise wird STRG+O häufig verwendet, um das Dialogfeld Gemeinsame Datei öffnen aufzurufen. Ein Automatisierungselement mit der AcceleratorKey-Eigenschaft kann das Invoke-Steuerelementmuster für die Aktion implementieren, die dem Tastenkombinationsbefehl entspricht. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Gibt die AccessKey-Eigenschaft an, bei der es sich um eine Zeichenfolge handelt, die das Zugriffsschlüsselzeichen für das Automation-Element enthält. Eine Zugriffstaste (manchmal auch als mnemonisch bezeichnet) ist ein Zeichen im Text eines Menüs, Menüelements oder einer Bezeichnung eines Steuerelements, z. B. einer Schaltfläche, das die zugehörige Menüfunktion aktiviert. Um beispielsweise das Menü Datei zu öffnen, für das die Zugriffstaste in der Regel F lautet, würde der Benutzer ALT+F drücken. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Identifiziert die AnnotationObjects-Eigenschaft , bei der es sich um eine Liste von Anmerkungsobjekten in einem Dokument handelt, z. B. Kommentar, Kopfzeile, Fußzeile usw. Variantentyp: VT_I4 | VT_ARRAY Standardwert: leeres Array |
|
Identifiziert die AnnotationTypes-Eigenschaft , bei der es sich um eine Liste der Anmerkungstypen in einem Dokument handelt, z. B. Kommentar, Kopfzeile, Fußzeile usw. Variantentyp: VT_I4 | VT_ARRAY Standardwert: leeres Array |
|
Gibt die AriaProperties-Eigenschaft an, bei der es sich um eine formatierte Zeichenfolge handelt, die die Eigenschafteninformationen der Accessible Rich Internet Application (ARIA) für das Automatisierungselement enthält. Weitere Informationen zum Zuordnen von ARIA-Zuständen und -Eigenschaften zu Eigenschaften und Funktionen der Benutzeroberflächenautomatisierung finden Sie unter Ui Automation for W3C Accessible Rich Internet Applications Specification. AriaProperties ist eine Sammlung von Name/Wert-Paaren mit Trennzeichen von = (gleich) und ; (Semikolon), z. B. "check=true;disabled=false". Der \ (umgekehrte Schrägstrich) wird als Escapezeichen verwendet, wenn diese Trennzeichen in \ den Werten angezeigt werden. Aus Sicherheitsgründen und aus anderen Gründen kann die Anbieterimplementierung dieser Eigenschaft Schritte unternehmen, um die ursprünglichen ARIA-Eigenschaften zu überprüfen. dies ist jedoch nicht erforderlich. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Gibt die AriaRole-Eigenschaft an, bei der es sich um eine Zeichenfolge handelt, die die Rolleninformationen für barrierefreie Rich Internet Application (ARIA) für das Automatisierungselement enthält. Weitere Informationen zum Zuordnen von ARIA-Rollen zu Steuerelementtypen der Benutzeroberflächenautomatisierung finden Sie unter Ui Automation for W3C Accessible Rich Internet Applications Specification. Hinweis:
|
|
Gibt die AutomationId-Eigenschaft an, bei der es sich um eine Zeichenfolge handelt, die den UI Automation-Bezeichner (ID) für das Automation-Element enthält. Wenn es verfügbar ist, muss die AutomationId eines Elements in jedem instance der Anwendung identisch sein, unabhängig von der lokalen Sprache. Der Wert sollte für gleichgeordnete Elemente eindeutig sein, aber nicht unbedingt auf dem gesamten Desktop eindeutig sein. Beispielsweise können mehrere Instanzen einer Anwendung oder mehrere Ordnersichten in Microsoft Windows Explorer Elemente mit derselben AutomationId-Eigenschaft enthalten, z. B. "SystemMenuBar". Obwohl die Unterstützung für AutomationId immer empfohlen wird, um automatisierte Tests besser zu unterstützen, ist diese Eigenschaft nicht obligatorisch. Wo es unterstützt wird, ist AutomationId nützlich, um ein Testautomatisierungsskript zu erstellen, das unabhängig von der Ui-Sprache ausgeführt wird. Clients sollten keine Annahmen hinsichtlich der AutomationId-Werte treffen, die von anderen Anwendungen verfügbar gemacht werden. AutomationId ist nicht garantiert, dass sie in verschiedenen Releases oder Builds einer Anwendung stabil ist. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Identifiziert die BoundingRectangle-Eigenschaft , die die Koordinaten des Rechtecks angibt, das das Automation-Element vollständig umschließt. Das Rechteck wird in physischen Bildschirmkoordinaten ausgedrückt. Es kann Punkte enthalten, die nicht geklickt werden können, wenn die Form oder der anklickbare Bereich des UI-Elements unregelmäßig ist oder wenn das Element durch andere Benutzeroberflächenelemente verdeckt wird. Variantentyp: VT_R8 | VT_ARRAY Standardwert: [0,0,0,0] Hinweis:
|
|
Gibt die CenterPoint-Eigenschaft an, die die zentrieren X- und Y-Punktkoordinaten des Automatisierungselements angibt. Der Koordinatenraum ist das, was der Anbieter logisch als Seite betrachtet. Variantentyp: VT_R8 | VT_ARRAY Standardwert: VT_EMPTY |
|
Gibt die ClassName-Eigenschaft an, bei der es sich um eine Zeichenfolge handelt, die den Klassennamen für das Automatisierungselement enthält, der vom Steuerelemententwickler zugewiesen wurde. Der Klassenname hängt von der Implementierung des Ui Automation-Anbieters ab und hat daher nicht immer ein Standardformat. Wenn der Klassenname jedoch bekannt ist, kann er verwendet werden, um zu überprüfen, ob eine Anwendung mit dem erwarteten Automatisierungselement funktioniert. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Gibt die ClickablePoint-Eigenschaft an, bei der es sich um einen Punkt auf dem Automation-Element handelt, auf den geklickt werden kann. Ein Element kann nicht geklickt werden, wenn es von einem anderen Fenster vollständig oder teilweise verdeckt wird. Variantentyp: VT_R8 | VT_ARRAY Standardwert: VT_EMPTY |
|
Identifiziert die ControllerFor-Eigenschaft , bei der es sich um ein Array von Automatisierungselementen handelt, die vom Automation-Element bearbeitet werden, das diese Eigenschaft unterstützt. ControllerFor wird verwendet, wenn sich ein Automatisierungselement auf ein oder mehrere Segmente der Anwendungsoberfläche oder des Desktops auswirkt. andernfalls ist es schwierig, die Auswirkungen des Steuerelementvorgangs ui-Elementen zuzuordnen. Dieser Bezeichner wird häufig für automatische Barrierefreiheit verwendet. Variantentyp für Anbieter: VT_UNKNOWN | VT_ARRAY Variantentyp für Clients: VT_UNKNOWN (IUIAutomationElementArray ) Standardwert: leeres Array |
|
Gibt die ControlType-Eigenschaft an, bei der es sich um eine Klasse handelt, die den Typ des Automation-Elements identifiziert. ControlType definiert Die Eigenschaften der UI-Elemente werden durch bekannte Benutzeroberflächensteuerelementgrundtypen wie Schaltflächen oder Kontrollkästchen definiert. Variantentyp: VT_I4 Standardwert: UIA_CustomControlTypeId Hinweis:
|
|
Gibt die Culture-Eigenschaft an, die einen Gebietsschemabezeichner für das Automatisierungselement enthält (z. B. 0x0409 für "en-US" oder Englisch (USA)).Jedes Gebietsschema verfügt über einen eindeutigen Bezeichner, einen 32-Bit-Wert, der aus einem Sprachbezeichner und einem Sortierreihenfolgebezeichner besteht. Der Gebietsschemabezeichner ist eine internationale Standard-numerische Abkürzung und verfügt über die Komponenten, die erforderlich sind, um eines der installierten vom Betriebssystem definierten Gebietsschemas eindeutig zu identifizieren. Weitere Informationen finden Sie unter Sprachbezeichnerkonstanten und Zeichenfolgen. Diese Eigenschaft kann auf Steuerelementbasis vorhanden sein, ist aber in der Regel nur auf Anwendungsebene verfügbar. Variantentyp: VT_I4 Standardwert: 0 |
|
Identifiziert die DescribedBy-Eigenschaft , bei der es sich um ein Array von Elementen handelt, die weitere Informationen zum Automation-Element bereitstellen. DescribedBy wird verwendet, wenn ein Automatisierungselement von einem anderen Segment der Anwendungsbenutzeroberfläche erläutert wird. Die -Eigenschaft kann beispielsweise auf ein Textelement von "2.529 Elemente in 85 Gruppen, 10 elemente ausgewählt" aus einem komplexen benutzerdefinierten Listenobjekt verweisen. Anstatt das Objektmodell für Clients zu verwenden, um ähnliche Informationen zu verarbeiten, kann die DescribeBy-Eigenschaft schnellen Zugriff auf das UI-Element bieten, das möglicherweise bereits nützliche Endbenutzerinformationen bietet, die das UI-Element beschreiben. Variantentyp für Anbieter: VT_UNKNOWN | VT_ARRAY Variantentyp für Clients: VT_UNKNOWN (IUIAutomationElementArray) Standardwert: leeres Array |
|
Gibt die FillColor-Eigenschaft an, die die Farbe angibt, die zum Füllen des Automatisierungselements verwendet wird. Dieses Attribut wird als COLORREF angegeben, ein 32-Bit-Wert, der zum Angeben einer RGB- oder RGBA-Farbe verwendet wird. Variantentyp: VT_I4 Standardwert: 0 |
|
Gibt die FillType-Eigenschaft an, die das Zum Ausfüllen des Automatisierungselements verwendete Muster angibt, z. B. none, Color, Gradient, Picture, Pattern usw. Variantentyp: VT_I4 Standardwert: 0 |
|
Gibt die FlowsFrom-Eigenschaft an, bei der es sich um ein Array von Automatisierungselementen handelt, das die Lesereihenfolge vor dem aktuellen Automatisierungselement vorschlägt. Wird ab Windows 8 unterstützt. Die FlowsFrom-Eigenschaft gibt die Lesereihenfolge an, wenn Automatisierungselemente nicht in derselben Lesereihenfolge verfügbar gemacht oder strukturiert werden, wie sie vom Benutzer wahrgenommen wird. Während die FlowsFrom-Eigenschaft mehrere vorangehende Elemente angeben kann, enthält sie in der Regel nur das vorherige Element in der Lesereihenfolge. Variantentyp für Anbieter: VT_UNKNOWN | VT_ARRAY Variantentyp für Clients: VT_UNKNOWN (IUIAutomationElementArray) Standardwert: leeres Array |
|
Gibt die FlowsTo-Eigenschaft an, bei der es sich um ein Array von Automatisierungselementen handelt, das die Lesereihenfolge nach dem aktuellen Automatisierungselement vorschlägt. Die FlowsTo-Eigenschaft gibt die Lesereihenfolge an, wenn Automatisierungselemente nicht in derselben Lesereihenfolge verfügbar gemacht oder strukturiert werden, wie sie vom Benutzer wahrgenommen wird. Während die FlowsTo-Eigenschaft mehrere nachfolgende Elemente angeben kann, enthält sie in der Regel nur das nächste Element in der Lesereihenfolge. Variantentyp für Anbieter: VT_UNKNOWN | VT_ARRAY Variantentyp für Clients: VT_UNKNOWN (IUIAutomationElementArray) Standardwert: leeres Array |
|
Identifiziert die FrameworkId-Eigenschaft , bei der es sich um eine Zeichenfolge handelt, die den Namen des zugrunde liegenden Ui-Frameworks enthält, zu dem das Automation-Element gehört. Die FrameworkId ermöglicht Es Clientanwendungen, Automatisierungselemente je nach dem jeweiligen UI-Framework unterschiedlich zu verarbeiten. Beispiele für Eigenschaftswerte sind "Win32", "WinForm" und "DirectUI". Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Die FullDescription-Eigenschaft macht eine lokalisierte Zeichenfolge verfügbar, die einen erweiterten Beschreibungstext für ein Element enthalten kann. FullDescription kann eine vollständigere Beschreibung eines Elements enthalten, als für das Element Name geeignet ist. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Identifiziert die HasKeyboardFocus-Eigenschaft , bei der es sich um einen booleschen Wert handelt, der angibt, ob das Automation-Element den Tastaturfokus hat. Variantentyp: VT_BOOL Standardwert: FALSE |
|
Gibt die HeadingLevel-Eigenschaft an, die die Überschriftenebene eines UI Automation-Elements angibt. Variantentyp: VT_I4 Standardwert: HeadingLevel_None |
|
Gibt die HelpText-Eigenschaft an, bei der es sich um eine Hilfetextzeichenfolge handelt, die dem Automation-Element zugeordnet ist. Die HelpText-Eigenschaft kann unterstützt werden, wenn Platzhaltertext in Bearbeitungs- oder Listensteuerelementen angezeigt wird. Beispielsweise ist "Text hier für die Suche eingeben" ein guter Kandidat für die HelpText-Eigenschaft für ein Bearbeitungssteuerelement, das den Text vor der tatsächlichen Eingabe des Benutzers platziert. Es ist jedoch nicht ausreichend für die name-Eigenschaft des Bearbeitungssteuerelements. Wenn HelpText unterstützt wird, muss die Zeichenfolge mit der Benutzeroberflächensprache der Anwendung oder der Standardsprache der Benutzeroberfläche des Betriebssystems übereinstimmen. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Gibt die IsContentElement-Eigenschaft an, bei der es sich um einen booleschen Wert handelt, der angibt, ob das Element in der Inhaltsansicht der Automatisierungselementstruktur angezeigt wird. Weitere Informationen finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungsstruktur. Hinweis:
|
|
Gibt die IsControlElement-Eigenschaft an, bei der es sich um einen booleschen Wert handelt, der angibt, ob das Element in der Steuerelementansicht der Automatisierungselementstruktur angezeigt wird. Weitere Informationen finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungsstruktur. Variantentyp: VT_BOOL Standardwert: TRUE |
|
Gibt die IsDataValidForForm-Eigenschaft an. Hierbei handelt es sich um einen booleschen Wert, der angibt, ob der eingegebene oder ausgewählte Wert für die Formularregel gültig ist, die dem Automation-Element zugeordnet ist. Wenn der Benutzer beispielsweise "425-555-5555" für ein Postleitzahlenfeld eingegeben hat, das 5 oder 9 Ziffern erfordert, kann die IsDataValidForForm-Eigenschaft auf FALSE festgelegt werden, um anzugeben, dass die Daten ungültig sind. Variantentyp: VT_BOOL Standardwert: FALSE |
|
Identifiziert die IsDialog-Eigenschaft , bei der es sich um einen booleschen Wert handelt, der angibt, ob das Automation-Element ein Dialogfeld ist. Beispielsweise sprechen Hilfstechnologien wie Bildschirmsprachausgaben in der Regel den Titel des Dialogfelds, das fokussierte Steuerelement im Dialogfeld und dann den Inhalt des Dialogfelds bis hin zum fokussierten Steuerelement ("Möchten Sie Ihre Änderungen vor dem Schließen speichern"). Bei Standardfenstern spricht eine Sprachausgabe in der Regel den Fenstertitel gefolgt vom fokussierten Steuerelement. Die IsDialog-Eigenschaft kann auf TRUE festgelegt werden, um anzugeben, dass die Clientanwendung das Element als Dialogfeld behandeln soll. Variantentyp: VT_BOOL Standardwert: FALSE |
|
Gibt die IsEnabled-Eigenschaft an, bei der es sich um einen booleschen Wert handelt, der angibt, ob das ui-Element, auf das vom Automation-Element verwiesen wird, aktiviert ist und mit dem interagiert werden kann. Wenn der aktivierte Status eines Steuerelements FALSE ist, wird davon ausgegangen, dass untergeordnete Steuerelemente ebenfalls nicht aktiviert sind. Clients sollten keine Eigenschaftsänderungen von untergeordneten Elementen erwarten, wenn sich der Zustand des übergeordneten Steuerelements ändert. Variantentyp: VT_BOOL Standardwert: FALSE |
|
Gibt die IsKeyboardFocusable-Eigenschaft an, bei der es sich um einen booleschen Wert handelt, der angibt, ob das Automation-Element den Tastaturfokus akzeptieren kann. Variantentyp: VT_BOOL Standardwert: FALSE |
|
Gibt die IsOffscreen-Eigenschaft an, bei der es sich um einen booleschen Wert handelt, der angibt, ob das Automation-Element vollständig aus der Ansicht scrollt (z. B. ein Element in einem Listenfeld, das sich außerhalb des Viewports des Containerobjekts befindet) oder aus der Sicht reduziert wird (z. B. ein Element in einer Strukturansicht oder einem Menü oder in einem minimierten Fenster). Wenn das Element über einen klickbaren Punkt verfügt, der dazu führen kann, dass es den Fokus empfängt, wird das Element als auf dem Bildschirm betrachtet, während sich ein Teil des Elements außerhalb des Bildschirms befindet. Der Wert der -Eigenschaft wird nicht durch die Verdeckung durch andere Fenster beeinflusst oder davon, ob das Element auf einem bestimmten Monitor sichtbar ist. Wenn die IsOffscreen-EigenschaftTRUE ist, wird das UI-Element vom Bildschirm gescrollt oder reduziert. Das Element wird vorübergehend ausgeblendet, bleibt jedoch in der Wahrnehmung des Endbenutzers und wird weiterhin in das UI-Modell einbezogen. Das Objekt kann durch Scrollen, Klicken auf eine Dropdownliste usw. wieder in die Ansicht gebracht werden. Objekte, die der Endbenutzer überhaupt nicht wahrnimmt oder die "programmgesteuert ausgeblendet" sind (z. B. ein Dialogfeld, das verworfen wurde, aber das zugrunde liegende Objekt weiterhin von der Anwendung zwischengespeichert wird), sollten sich überhaupt nicht in der Automatisierungselementstruktur befinden (anstatt den Status von IsOffscreen auf TRUE festzulegen). Variantentyp: VT_BOOL Standardwert: FALSE |
|
Gibt die IsPassword-Eigenschaft an, bei der es sich um einen booleschen Wert handelt, der angibt, ob das Automation-Element geschützte Inhalte oder ein Kennwort enthält. Wenn die IsPassword-EigenschaftTRUE ist und das Element über den Tastaturfokus verfügt, sollte eine Clientanwendung das Echo der Tastatur oder das Feedback zur Tastatureingabe deaktivieren, wodurch die geschützten Informationen des Benutzers verfügbar gemacht werden können. Der Versuch, auf die Value-Eigenschaft des geschützten Elements (Steuerelement bearbeiten) zuzugreifen, kann zu einem Fehler führen. Variantentyp: VT_BOOL Standardwert: FALSE |
|
Gibt die IsPeripheral-Eigenschaft an, bei der es sich um einen booleschen Wert handelt, der angibt, ob das Automation-Element die peripherierische Benutzeroberfläche darstellt. Die Peripherie-Benutzeroberfläche wird angezeigt und unterstützt die Benutzerinteraktion, jedoch nicht den Tastaturfokus, wenn sie angezeigt wird. Beispiele für Peripheriebenutzeroberfläche sind Popups, Flyouts, Kontextmenüs oder schwebende Benachrichtigungen. Wird ab Windows 8.1 unterstützt. Wenn die IsPeripheral-EigenschaftTRUE ist, kann eine Clientanwendung nicht davon ausgehen, dass der Fokus vom Element übernommen wurde, auch wenn es sich derzeit um eine interaktive Tastatur handelt. Diese Eigenschaft ist für diese Steuerelementtypen relevant:
Standardwert: FALSE |
|
Gibt die IsRequiredForForm-Eigenschaft an, bei der es sich um einen booleschen Wert handelt, der angibt, ob das Automation-Element für ein Formular ausgefüllt werden muss. Variantentyp: VT_BOOL Standardwert: FALSE |
|
Gibt die ItemStatus-Eigenschaft an. Hierbei handelt es sich um eine Textzeichenfolge, die die status eines Elements des Automation-Elements beschreibt. ItemStatus ermöglicht es einem Client zu ermitteln, ob ein Element status zu einem Element übermittelt und was das status ist. Ein Element, das einem Kontakt in einer Messaginganwendung zugeordnet ist, kann beispielsweise "Busy" oder "Connected" sein. Wenn ItemStatus unterstützt wird, muss die Zeichenfolge mit der Benutzeroberflächensprache der Anwendung oder der Standardsprache der Benutzeroberfläche des Betriebssystems übereinstimmen. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Gibt die ItemType-Eigenschaft an, bei der es sich um eine Textzeichenfolge handelt, die den Typ des Automation-Elements beschreibt. ItemType wird verwendet, um Informationen zu Elementen in einer Liste, Strukturansicht oder Datenraster abzurufen. Ein Element in einer Dateiverzeichnisansicht kann beispielsweise eine "Dokumentdatei" oder ein "Ordner" sein. Wenn ItemType unterstützt wird, muss die Zeichenfolge mit der Benutzeroberflächensprache der Anwendung oder der Standardsprache der Benutzeroberfläche des Betriebssystems übereinstimmen. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Gibt die LabeledBy-Eigenschaft an, bei der es sich um ein Automatisierungselement handelt, das die Textbezeichnung für dieses Element enthält. Diese Eigenschaft kann verwendet werden, um z. B. die statische Textbeschriftung für ein Kombinationsfeld abzurufen. Variantentyp: VT_UNKNOWN Standardwert: NULL |
|
Gibt die LandmarkType-Eigenschaft an, bei der es sich um einen Landmark Type Identifier handelt, der einem Element zugeordnet ist. Die LandmarkType-Eigenschaft beschreibt ein Element, das eine Gruppe von Elementen darstellt. Beispielsweise könnte ein Suchpunkt eine Reihe verwandter Steuerelemente für die Suche darstellen. Wenn UIA_CustomLandmarkTypeId verwendet wird, ist UIA_LocalizedLandmarkTypePropertyId erforderlich, um das benutzerdefinierte Wahrzeichen zu beschreiben. Variantentyp: VT_I4 Standardwert: 0 |
|
Gibt die Level-Eigenschaft an, bei der es sich um eine 1-basierte ganze Zahl handelt, die einem Automatisierungselement zugeordnet ist. Die Level-Eigenschaft beschreibt die Position eines Elements innerhalb einer hierarchischen oder unterbrochenen hierarchischen Struktur. Beispielsweise können eine Aufzählungs-/Nummerierungsliste, Überschriften oder andere strukturierte Datenelemente verschiedene übergeordnete/untergeordnete Beziehungen aufweisen. Level beschreibt, wo sich das Element in der Struktur befindet. Es wird empfohlen, das CustomNavigation-Steuerelementmuster zusammen mit Level zu verwenden. Variantentyp: VT_I4 Standardwert: 0 |
|
Gibt die LiveSetting-Eigenschaft an, die von einem Automation-Element unterstützt wird, das eine Liveregion darstellt. Die LiveSetting-Eigenschaft gibt die Höflichkeitsebene an, die ein Client verwenden soll, um den Benutzer über Änderungen an der Liveregion zu benachrichtigen. Diese Eigenschaft kann einer der Werte aus der LiveSetting-Enumeration sein. Wird ab Windows 8 unterstützt. Variantentyp: VT_I4 Standardwert: 0 |
|
Gibt die LocalizedControlType-Eigenschaft an. Hierbei handelt es sich um eine Textzeichenfolge, die den Typ des Steuerelements beschreibt, das das Automation-Element darstellt. Die Zeichenfolge sollte nur Kleinbuchstaben enthalten:
Wenn LocalizedControlType vom Elementanbieter nicht angegeben wird, wird die lokalisierte Standardzeichenfolge vom Framework gemäß dem Steuerelementtyp des Elements bereitgestellt (z. B. "button" für den Button-Steuerelementtyp ). Ein Automatisierungselement mit dem Typ Benutzerdefiniertes Steuerelement muss eine lokalisierte Steuerelementtypzeichenfolge unterstützen, die die Rolle des Elements darstellt (z. B. "Farbauswahl" für ein benutzerdefiniertes Steuerelement, mit dem Benutzer Farben auswählen und angeben können). Wenn ein benutzerdefinierter Wert angegeben wird, muss die Zeichenfolge mit der Benutzeroberflächensprache der Anwendung oder der Standardsprache der Benutzeroberfläche des Betriebssystems übereinstimmen. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Gibt den LocalizedLandmarkType an. Hierbei handelt es sich um eine Textzeichenfolge, die den Typ des Meilensteins beschreibt, den das Automation-Element darstellt. Dies sollte zusammen mit UIA_CustomLandmarkTypeIdLocalizedLandmarkType sollte jedoch immer Vorrang vor LandmarkType haben und zur Beschreibung des Wahrzeichens vor LandmarkType verwendet werden. Die Zeichenfolge muss mit der Anwendungsoberflächensprache oder der Standardsprache der Benutzeroberfläche des Betriebssystems übereinstimmen. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Gibt die Name-Eigenschaft an, bei der es sich um eine Zeichenfolge handelt, die den Namen des Automation-Elements enthält. 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 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 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. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Gibt die NativeWindowHandle-Eigenschaft an, bei der es sich um eine ganze Zahl handelt, die den Handle (HWND) des Automatisierungselementfensters darstellt, sofern vorhanden; Andernfalls ist diese Eigenschaft 0. Variantentyp: VT_I4 Standardwert: 0 |
|
Identifiziert die OptimizeForVisualContent-Eigenschaft , bei der es sich um einen booleschen Wert handelt, der angibt, ob der Anbieter nur elemente verfügbar macht, die sichtbar sind. Ein Anbieter kann diese Eigenschaft verwenden, um die Leistung bei der Arbeit mit sehr großen Inhalten zu optimieren. Wenn der Benutzer beispielsweise seitenweise einen großen Inhalt durchläuft, kann der Anbieter Inhaltselemente zerstören, die nicht mehr sichtbar sind. Wenn ein Inhaltselement zerstört wird, sollte der Anbieter den UIA_E_ELEMENTNOTAVAILABLE Fehlercode zurückgeben. Wird ab Windows 8 unterstützt. Variantentyp: VT_BOOL Standardwert: FALSE |
|
Gibt die Orientation-Eigenschaft an, die die Ausrichtung des Steuerelements angibt, das durch das Automation-Element dargestellt wird. Die -Eigenschaft wird als Wert aus dem aufgezählten OrientationType-Typ ausgedrückt. Die Orientation-Eigenschaft wird von Steuerelementen unterstützt, z. B. Bildlaufleisten und Schiebereglern, die entweder eine vertikale oder eine horizontale Ausrichtung aufweisen können. Andernfalls kann es immer OrientationType_None werden, was bedeutet, dass das Steuerelement keine Ausrichtung hat. Variantentyp: VT_I4 Standardwert: 0 (OrientationType_None) |
|
Gibt die OutlineColor-Eigenschaft an, die die Farbe angibt, die für die Gliederung des Automatisierungselements verwendet wird. Dieses Attribut wird als COLORREF angegeben, ein 32-Bit-Wert, der zum Angeben einer RGB- oder RGBA-Farbe verwendet wird. Variantentyp: VT_I4 | VT_ARRAY Standardwert: 0 |
|
Gibt die OutlineThickness-Eigenschaft an, die die Breite für die Gliederung des Automation-Elements angibt. Variantentyp: VT_R8 | VT_ARRAY Standardwert: VT_EMPTY |
|
Gibt die PositionInSet-Eigenschaft an, bei der es sich um eine 1-basierte Ganzzahl handelt, die einem Automatisierungselement zugeordnet ist. PositionInSet beschreibt die Ordnungsposition des Elements innerhalb einer Gruppe von Elementen, die als gleichgeordnet gelten. PositionInSet arbeitet in Abstimmung mit der SizeOfSet-Eigenschaft , um die Ordnungsposition im Satz zu beschreiben. Variantentyp: VT_I4 Standardwert: 0 |
|
Gibt die ProcessId-Eigenschaft an, bei der es sich um eine ganze Zahl handelt, die den Prozessbezeichner (ID) des Automatisierungselements darstellt. Der Prozessbezeichner (ID) wird vom Betriebssystem zugewiesen. Dies kann in der Spalte PID der Registerkarte Prozesse im Task-Manager angezeigt werden. Variantentyp: VT_I4 Standardwert: 0 |
|
Gibt die ProviderDescription-Eigenschaft an, bei der es sich um eine formatierte Zeichenfolge handelt, die die Quellinformationen des Benutzeroberflächenautomatisierungsanbieters für das Automation-Element enthält, einschließlich Proxyinformationen. Variantentyp: VT_BSTR Standardwert: leere Zeichenfolge |
|
Identifiziert die Rotationseigenschaft , die den Drehwinkel in nicht angegebenen Einheiten angibt. Variant-Typ: VT_R8 Standardwert: 0 |
|
Gibt die RuntimeId-Eigenschaft an, bei der es sich um ein Array von ganzen Zahlen handelt, die den Bezeichner für ein Automatisierungselement darstellen. Der Bezeichner ist auf dem Desktop eindeutig, aber er ist garantiert nur innerhalb der Benutzeroberfläche des Desktops, auf dem er generiert wurde, eindeutig. Bezeichner können im Laufe der Zeit wiederverwendet werden. Das Format von RuntimeId kann sich ändern. Der zurückgegebene Bezeichner sollte als undurchsichtiger Wert behandelt und nur zum Vergleich verwendet werden. beispielsweise, um zu bestimmen, ob sich ein Automatisierungselement im Cache befindet. Variantentyp: VT_I4 | VT_ARRAY Standardwert: VT_EMPTY |
|
Gibt die Size-Eigenschaft an, die die Breite und Höhe des Automatisierungselements angibt. Variantentyp: VT_R8 | VT_ARRAY Standardwert: VT_EMPTY |
|
Gibt die SizeOfSet-Eigenschaft an, bei der es sich um eine 1-basierte Ganzzahl handelt, die einem Automatisierungselement zugeordnet ist. SizeOfSet beschreibt die Anzahl der Automatisierungselemente in einer Gruppe oder Gruppe, die als gleichgeordnet betrachtet werden. SizeOfSet arbeitet in Abstimmung mit der PositionInSet-Eigenschaft , um die Anzahl der Elemente im Satz zu beschreiben. Variantentyp: VT_I4 Standardwert: 0 |
|
Identifiziert die VisualEffects-Eigenschaft , bei der es sich um ein Bitfeld handelt, das Auswirkungen auf das Automatisierungselement angibt, z. B. Schatten, Reflexion, Leuchten, weiche Kanten oder Abschrägungen. VisualEffects:
Standardwert: 0 |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Header |
|
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für