Textsteuertyp
Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung Unterstützung für den Text-Steuerelementtyp.
Ein Textsteuerelement ist ein einfaches Element der Benutzeroberfläche, das einen Text auf dem Bildschirm darstellt.
In den folgenden Abschnitten werden die Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Text-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung gelten für alle Struktursteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Strukturstruktur
Die folgende Tabelle zeigt ein typisches Steuerelement und eine Inhaltsansicht der Benutzeroberflächenautomatisierung struktur, die sich auf Textsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur Benutzeroberflächenautomatisierung Struktur finden Sie unter Benutzeroberflächenautomatisierung Strukturübersicht.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Ein Textsteuerelement kann eigenständig als Bezeichnung oder als statischer Text auf 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ächenautomatisierung angezeigt, da Text häufig über die Name-Eigenschaft eines anderen Steuerelements angezeigt wird. Beispielsweise wird der Text, der zum Beschriften eines Kombinationsfeld-Steuerelements verwendet wird, über die Name-Eigenschaft des Steuerelements verfügbar gemacht. Da sich das Kombinationsfeld-Steuerelement in der Inhaltsansicht der Benutzeroberflächenautomatisierung befindet, muss das Textsteuerfeld nicht dort sein. Textsteuerelemente können in der Inhaltsansicht über ein eingebettetes Objekt wie einen Link verfügen.
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, deren Wert oder Definition für die Textsteuerelemente besonders relevant ist. Weitere Informationen zu Eigenschaften Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA _ AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Struktur der Benutzeroberflächenautomatisierung sein. |
| UIA _ BoundingRectanglePropertyId | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| UIA _ ClickablePointPropertyId | Siehe Hinweise. | Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht jeder Punkt innerhalb des umgebundenen Rechtecks angeklickt werden kann und das Element spezielle Treffertests ausführt, überschreiben Und stellen Sie einen klickbaren Punkt zur Verfügung. |
| UIA _ ControlTypePropertyId | Text | |
| UIA _ IsContentElementPropertyId | Depends (Abhängig) | Das Textsteuerfeld ist inhalt, wenn es Informationen enthält, die nicht in der Name-Eigenschaft eines anderen Steuerelements verfügbar gemacht werden. |
| UIA _ IsControlElementPropertyId | TRUE | Das Textsteuerelement muss stets ein Steuerelement sein. |
| UIA _ IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA _ LabeledByPropertyId | NULL | Textsteuerelemente haben keine statische Textbezeichnung. |
| UIA _ LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem Text-Steuerelementtyp entspricht. Der Standardwert ist "text" für en-US oder Englisch (USA). |
| UIA _ NamePropertyId | Siehe Hinweise. | Der Name eines Textsteuerfelds kann der angezeigte Text sein. Wenn das Steuerelement jedoch auch das Textmuster unterstützt und der Text umfangreich ist, verwenden Sie nicht den Volltextinhalt als Name-Wert. Geben Sie stattdessen einen kürzeren Name-Wert an, der von anderen Eigenschaften des Steuerelements abgeleitet wird. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, die von Textsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Notizen |
|---|---|---|
| IGridItemProvider | Depends (Abhängig) | Wenn das Textsteuerfeld in einem Tabellensteuerfeld enthalten ist, muss das GridItem-Steuerelementmuster unterstützt werden. |
| ITableItemProvider | Depends (Abhängig) | Wenn das Textsteuerfeld in einem Tabellensteuerfeld enthalten ist, muss das TableItem-Steuerelementmuster unterstützt werden. |
| ITextProvider | Depends (Abhängig) | Text sollte das Text-Steuerelementmuster unterstützen, um die Barrierefreiheit zu verbessern. dies ist jedoch nicht erforderlich. Das Text-Steuerelementmuster ist nützlich, wenn der Text viele Formate und Attribute hat (z. B., Farbe, Fettdruck und Kursivdruck). |
| IValueProvider | Nie | Ein Textsteuerfeld unterstützt nie das Value-Steuerelementmuster. Wenn der Text bearbeitbar ist, ist er der Steuerelementtyp Bearbeiten. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung aufgeführt, die Textsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Benutzeroberflächenautomatisierung-Ereignis | Notizen |
|---|---|
| UIA _ AutomationFocusChangedEventId | |
| UIA _ BoundingRectanglePropertyId-Eigenschaftsänderungsereignis. | |
| UIA _ IsEnabledPropertyId-Eigenschaftsänderungsereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ IsOffscreenPropertyId-Eigenschaftsänderungsereignis. | 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-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |