Textsteuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung des Text-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.

Ein Textsteuerelement ist ein einfaches Benutzeroberflächenelement, das einen Text auf dem Bildschirm darstellt.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Text-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Struktursteuerelemente, in denen das Benutzeroberflächenframework bzw. die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Textsteuerelemente bezieht, und beschreibt, was in den einzelnen Ansichten enthalten sein kann. 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 der folgenden Elemente enthalten sein:

Textsteuerelemente werden möglicherweise nicht in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur angezeigt, da Text häufig über die Name-Eigenschaft eines anderen Steuerelements angezeigt wird. Beispielsweise wird der Text, der zum Beschriften eines Kombinationsfeldsteuerelements verwendet wird, über die Name-Eigenschaft des Steuerelements verfügbar gemacht. Da sich das Kombinationsfeldsteuerelement in der Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur befindet, muss das Textsteuerelement nicht vorhanden sein. Textsteuerelemente können untergeordnete Elemente in der Inhaltsansicht aufweisen, wenn ein eingebettetes Objekt wie z. B. ein Link vorhanden ist.

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition besonders für die Textsteuerelemente relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elementen.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung Struktur eindeutig 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 umgebenden Rechtecks geklickt werden kann, und das Element spezielle Treffertests durchführt, überschreiben Sie es, und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId Text
UIA_IsContentElementPropertyId Depends (Abhängig) Das Textsteuerelement ist Inhalt, wenn es Informationen enthält, die in der Name-Eigenschaft eines anderen Steuerelements nicht 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 English (USA).
UIA_NamePropertyId Siehe Hinweise. Der Name eines Textsteuerelements kann der angezeigte Text sein. Wenn das Steuerelement jedoch auch das Textmuster unterstützt und der Text umfangreich ist, verwenden Sie nicht den vollständigen Textinhalt als Name-Wert . Geben Sie stattdessen einen kürzeren Name-Wert an, der von anderen Eigenschaften Des Steuerelements abgeleitet ist.

 

Erforderliche 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
IGridItemProvider Depends (Abhängig) Wenn das Textsteuerelement in einem Tabellensteuerelement enthalten ist, muss das GridItem-Steuerelementmuster unterstützt werden.
ITableItemProvider Depends (Abhängig) Wenn das Textsteuerelement in einem Tabellensteuerelement enthalten ist, muss das TableItem-Steuerelementmuster unterstützt werden.
ITextProvider Depends (Abhängig) Text sollte das Text-Steuerelementmuster unterstützen, um eine bessere Barrierefreiheit zu gewährleisten. 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 Textsteuerelement unterstützt nie das Value-Steuerelementmuster . Wenn der Text bearbeitbar ist, handelt es sich um den Steuerelementtyp Bearbeiten .

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Textsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Hinweise
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis.
UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_NamePropertyId Eigenschaft geändertes Ereignis.
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