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

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
  • Text
  • Text (wenn Inhalt)

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.

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung