Textsteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den steuerelementtyp Text.
Ein Textsteuerelement ist ein einfaches Benutzeroberflächenelement, das einen Textabschnitt auf dem Bildschirm darstellt.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den steuerelementtyp Text definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Struktursteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält die folgenden Abschnitte.
- typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Verwandte Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Textsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Ein Textsteuerelement kann allein als Beschriftung oder als statischer Text in einem Formular verwendet werden. Sie kann auch in der Struktur eines der folgenden Elemente enthalten sein:
Textsteuerelemente werden möglicherweise nicht in der Inhaltsansicht der Benutzeroberflächenautomatisierungsstruktur angezeigt, da Text häufig über die Name Eigenschaft eines anderen Steuerelements angezeigt wird. Beispielsweise wird der Text, der zum Bezeichnen eines Kombinationsfeld-Steuerelements verwendet wird, über die Name-Eigenschaft des Steuerelements verfügbar gemacht. Da sich das Kombinationsfeld-Steuerelement in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur befindet, muss das Textsteuerelement nicht vorhanden sein. Textsteuerelemente verfügen möglicherweise über untergeordnete Elemente in der Inhaltsansicht, wenn ein eingebettetes Objekt wie ein Link vorhanden ist.
Relevante Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für die Textsteuerelemente relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA_AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein. |
| UIA_BoundingRectanglePropertyId | Siehe Hinweise. | Das äußerste Rechteck, das das gesamte Steuerelement enthält. |
| UIA_ClickablePointPropertyId | Siehe Hinweise. | Wird unterstützt, wenn ein umgebendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umgebenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreiben Und stellen Sie einen klickbaren Punkt bereit. |
| UIA_ControlTypePropertyId | ||
| UIA_IsContentElementPropertyId | Hängt | Das Textsteuerelement ist Inhalt, wenn es Informationen enthält, die in der Name-Eigenschaft eines anderen Steuerelements nicht verfügbar gemacht werden. |
| UIA_IsControlElementPropertyId | STIMMT | Das Textsteuerelement muss immer ein Steuerelement sein. |
| UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA_LabeledByPropertyId | NULL | Textsteuerelemente verfügen nicht über eine statische Textbezeichnung. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem steuerelementtyp Text entspricht. Der Standardwert ist "text" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Der Name eines Textsteuerelements kann der angezeigte Text sein. Wenn das Steuerelement jedoch auch das Text Muster unterstützt und der Text umfangreich ist, verwenden Sie den Volltextinhalt nicht als Name Wert. Geben Sie stattdessen einen Name Wert an, der kürzer ist und von anderen Eigenschaften des Steuerelements abgeleitet ist. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von Textsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
| Steuerelementmuster | Unterstützen | Notizen |
|---|---|---|
| IGridItemProvider- | Hängt | Wenn das Textsteuerelement in einem Tabellensteuerelement enthalten ist, muss das GridItem- Steuerelementmuster unterstützt werden. |
| ITableItemProvider- | Hängt | Wenn das Textsteuerelement in einem Tabellensteuerelement enthalten ist, muss das TableItem- Steuerelementmuster unterstützt werden. |
| ITextProvider- | Hängt | Text sollte das Text Steuerelementmusters unterstützen, um die Barrierefreiheit zu verbessern; Es ist jedoch nicht erforderlich. Das Text-Steuerelementmuster ist nützlich, wenn der Text umfangreiche Formatvorlagen und Attribute aufweist (z. B. Farbe, Fett und Kursiv). |
| IValueProvider- | Nie | Ein Textsteuerelement unterstützt nie das steuerelementmuster Value. Wenn der Text bearbeitbar ist, handelt es sich um den Bearbeitungs- Steuerelementtyp. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die textsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Notizen |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis. | |
| UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden. |
| UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. | Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_NamePropertyId Eigenschaftsänderungsereignis. | |
| UIA_StructureChangedEventId | |
| UIA_Text_TextChangedEventId | Wenn das Steuerelement das Text- Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen. |
Verwandte Themen
-
Konzeptionelle
-
Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung