Freigeben über


Benutzeroberflächenautomatisierungs-Unterstützung für den Text-Steuerelementtyp

Hinweis

Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.

Dieser Artikel enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den Steuerelementtyp „Text“. Bei der Benutzeroberflächenautomatisierung entspricht ein Steuerelementtyp einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty-Eigenschaft verwendet zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur der Benutzeroberflächenautomatisierung, Eigenschaftswerte der Benutzeroberflächenautomatisierung und Steuerelementmuster.

Textsteuerelemente sind grundlegende Benutzeroberflächenelemente, die ein Stück Text auf dem Bildschirm darstellen.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „Text“ definiert. Die Anforderungen für die Benutzeroberflächenautomatisierung gelten für alle Textsteuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für Textsteuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

Steuerelementansicht Inhaltsansicht
Text Text (wenn Inhalt)

Ein Textsteuerelement kann eigenständig als Bezeichnung oder als statischer Text auf einem Formular verwendet werden. Es kann auch in der Struktur eines Elements folgende Typs enthalten sein:

  • ListItem

  • TreeItem

  • DataItem

Textsteuerelemente sind manchmal nicht in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur vorhanden, da Text häufig über die NameProperty eines anderen Steuerelements angezeigt wird. So wird zum Beispiel der Text, mit dem ein Kombinationsfeld-Steuerelement beschriftet ist, über den NameProperty -Wert des Steuerelements verfügbar gemacht. Da sich das Kombinationsfeld-Steuerelement in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur befindet, muss das Textsteuerelement dort nicht vorhanden sein. Textsteuerelemente haben in der Inhaltsansicht immer 0 untergeordnete Elemente.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

Die folgende Tabelle enthält die Benutzeroberflächenautomatisierungs-Eigenschaften, deren Werte oder Definitionen für Textsteuerelemente besonders relevant sind. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Eigenschaften der Benutzeroberflächenautomatisierung für Clients.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
AutomationIdProperty Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein.
BoundingRectangleProperty Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
ClickablePointProperty Siehe Hinweise. Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht auf jeden Punkt innerhalb des umschließenden Rechtecks geklickt werden kann, und Sie spezielle Treffertests ausführen, setzen Sie die Eigenschaft außer Kraft, und stellen Sie dann einen klickbaren Punkt bereit.
IsKeyboardFocusableProperty Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
NameProperty Siehe Hinweise. Der Name des Textsteuerelements ist immer der Name der TXT-Datei, die im Steuerelement angezeigt wird.
LabeledByProperty Null Textsteuerelemente haben keine statische Textbezeichnung.
ControlTypeProperty Text Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
LocalizedControlTypeProperty "text" Lokalisierte Zeichenfolge für den Steuerelementtyp „Text“.
IsContentElementProperty Depends (Abhängig) Das Textsteuerelement ist Inhalt, wenn es Informationen enthält, die nicht in der NameProperty-Eigenschaft eines anderen Steuerelements verfügbar gemacht sind.
IsControlElementProperty True Das Textsteuerelement muss stets ein Steuerelement sein.

Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster

In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von Textsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster Support Hinweise
IValueProvider Nie Text unterstützt nie „ValuePattern“. Wenn der Text bearbeitet werden kann, ist dies der Edit-Steuerelementtyp.
ITextProvider Depends (Abhängig) Für eine verbesserte Barrierefreiheit sollte Text das Text-Steuerelementmuster unterstützen. 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). Abhängig vom Framework.
ITableItemProvider Depends (Abhängig) Wenn das Textelement in einem Tabellensteuerelements enthalten ist, muss dies unterstützt werden.
IRangeValueProvider Depends (Abhängig) Wenn das Textelement in einem Tabellensteuerelements enthalten ist, muss dies unterstützt werden.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabellen sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Textsteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Support Notizen
TextSelectionChangedEvent Erforderlich Keine
TextChangedEvent Erforderlich Keine
Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis. Erforderlich Keine
Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis. Erforderlich Keine
Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis. Erforderlich Keine
Durch geänderteNameProperty -Eigenschaft ausgelöstes Ereignis. Erforderlich Keine
Durch geänderteValueProperty -Eigenschaft ausgelöstes Ereignis. Nie Keine
AutomationFocusChangedEvent Erforderlich Keine
StructureChangedEvent Erforderlich Keine

Siehe auch