Benutzeroberflächenautomatisierungs-Unterstützung für den Text-Steuerelementtyp
Aktualisiert: November 2007
Dieses Thema enthält Informationen zur UI-Automatisierung-Unterstützung für den Text-Steuerelementtyp. In UI-Automatisierung umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte und Steuerelementmuster ein.
Text-Steuerelemente sind grundlegende Benutzeroberflächenelemente, die ein Stück Text auf dem Bildschirm darstellen.
In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Text-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-Anforderungen gelten für alle Text-Steuerelemente, seien dies Windows Presentation Foundation (WPF)-, Win32- oder Windows Forms-Steuerelemente.
Dieses Thema enthält folgende Abschnitte.
- Erforderliche Benutzeroberflächenautomatisierungs-Struktur
- Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
- Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
- Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
- Verwandte Abschnitte
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur für Text-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
|
|
Ein Text-Steuerelement kann eigenständig als Bezeichnung oder als statischer Text in einem Formular verwendet werden. Es kann auch innerhalb der Struktur eines der folgenden Steuerelemente enthalten sein:
ListItem
TreeItem
DataItem
Text-Steuerelemente sind manchmal nicht in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten, 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 Text-Steuerelement selbst dort nicht vorhanden sein. Text-Steuerelemente haben in der Inhaltsansicht stets 0 untergeordnete Elemente.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle werden die UI-Automatisierung-Eigenschaften aufgelistet, deren Werte oder Definitionen für Text-Steuerelemente besonders wichtig sind. Weitere Informationen über die UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
UI-Automatisierung-Eigenschaft |
Wert |
Hinweise |
|---|---|---|
AutomationIdProperty() |
Siehe Hinweise. |
Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein. |
Siehe Hinweise. |
Das äußere Rechteck, welches das gesamte Steuerelement umfasst. |
|
Siehe Hinweise. |
Unterstützt, wenn ein umschließendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks durch Klicken aktiviert werden kann und Sie eine spezielle Trefferprüfung ausführen, setzen Sie diese Eigenschaft außer Kraft, und geben Sie einen durch Klicken aktivierbaren Punkt an. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
Siehe Hinweise. |
Der Name des Textleisten-Steuerelements ist immer die von diesem angezeigte TXT-Datei. |
|
Null |
Text-Steuerelemente verfügen über keine statische Beschriftung. |
|
Text |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
"Text" |
Lokalisierte Zeichenfolge für den Text-Steuerelementtyp. |
|
Variabel |
Das Text-Steuerelement ist Inhalt, wenn es Informationen enthält, die nicht in der NameProperty-Eigenschaft eines anderen Steuerelements verfügbar gemacht sind. |
|
True |
Das Text-Steuerelement muss stets ein Steuerelement sein. |
Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
In der folgenden Tabelle sind die UI-Automatisierung-Steuerelementmuster aufgeführt, die von allen Text-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.
Steuerelementmuster/Mustereigenschaft |
Unterstützung/Wert |
Hinweise |
|---|---|---|
Nie |
Text unterstützt nie ValuePattern. Wenn der Text bearbeitet werden kann, handelt es sich um den Edit-Steuerelementtyp. |
|
Variabel |
Abhängig vom Framework. |
|
Variabel |
Wenn das Textelement innerhalb eines Table-Steuerelements enthalten ist, muss dies unterstützt werden. |
|
Variabel |
Wenn das Textelement innerhalb eines Table-Steuerelements enthalten ist, muss dies unterstützt werden. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die UI-Automatisierung-Ereignisse aufgeführt, die von allen Text-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.
UI-Automatisierung-Ereignis |
Unterstützung |
Hinweise |
|---|---|---|
Erforderlich |
Keine |
|
Erforderlich |
Keine |
|
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis. |
Erforderlich |
Keine |
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis. |
Erforderlich |
Keine |
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis. |
Erforderlich |
Keine |
Durch geänderte NameProperty-Eigenschaft ausgelöstes Ereignis. |
Erforderlich |
Keine |
Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis. |
Nie |
Keine |
Erforderlich |
Keine |
|
Erforderlich |
Keine |
Siehe auch
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung
Übersicht über die Benutzeroberflächenautomatisierung