Benutzeroberflächenautomatisierungs-Unterstützung für den ComboBox-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 „ComboBox“. 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, Steuerelementmuster und Ereignisse der Benutzeroberflächenautomatisierung.
Ein Kombinationsfeld ist ein Listenfeld, das mit einem statischen Steuerelement oder einem Bearbeitungssteuerelement kombiniert ist und das momentan ausgewählte Element im Listenfeldbereich des Kombinationsfelds anzeigt. Der Listenfeldbereich des Steuerelements wird dauerhaft oder nur dann angezeigt, wenn der Dropdownpfeil (der eine Schaltfläche ist) neben dem Steuerelement ausgewählt wurde. Wenn das Auswahlfeld ein Bearbeitungssteuerelement ist, kann der Benutzer Informationen eingeben, die in der Liste nicht vorhanden sind. Andernfalls kann er nur Elemente in der Liste auswählen.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „ComboBox“ definiert. Die Anforderungen für die UI-Automatisierung gelten für alle Kombinationsfeld-Steuerelemente, unabhängig davon, ob es sich um Windows Presentation Foundation (WPF), Win32 oder Windows Forms handelt.
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für Steuerelemente des Kombinationsfelds 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 |
|---|---|
| Kombinationsfeld - Bearbeitung (0 oder 1) - Liste (1) - Listenelement (untergeordnetes Element von Liste; 0 bis viele) - Schaltfläche (1) |
Kombinationsfeld - Listenelement (0 bis viele) |
Das Bearbeitungssteuerelement in der Steuerelementansicht des Kombinationsfelds ist nur erforderlich, wenn das Kombinationsfeld bearbeitet werden kann, um beliebige Eingaben anzunehmen, wie dies für das Kombinationsfeld im Dialogfeld „Ausführen“ der Fall ist.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
Die folgende Tabelle enthält die Benutzeroberflächenautomatisierungs-Eigenschaften, deren Werte oder Definitionen für Combobox-Steuerelemente 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. |
| ControlTypeProperty | Kombinationsfeld | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| HelpTextProperty | Siehe Hinweise. | Der Hilfetext für ein Kombinationsfeld-Steuerelement sollte erläutern, warum der Benutzer aufgefordert wird, eine Option im Kombinationsfeld auszuwählen. Der Text ist mit den in einer QuickInfo angezeigten Informationen vergleichbar. Beispiel: „Wählen Sie ein Element aus, um die Anzeigeauflösung des Bildschirms festzulegen.“ |
| IsContentElementProperty | True | Kombinationsfeld-Steuerelemente sind immer in der Inhaltsansicht der UI Automatisierungsstruktur enthalten. |
| IsControlElementProperty | True | Kombinationsfeld-Steuerelemente sind immer in der Inhaltsansicht der UI Automatisierungsstruktur enthalten. |
| IsKeyboardFocusableProperty | True | Kombinationsfeld-Steuerelemente machen einen Satz von Elementen aus einem Auswahlcontainer verfügbar. Das Kombinationsfeld-Steuerelement (ComboBox) kann den Tastaturfokus erhalten, aber wenn ein Benutzeroberflächenautomatisierungs-Client den Fokus auf ein Kombinationsfeld setzt, können ggf. alle Elemente in der Unterstruktur des Kombinationsfelds den Fokus erhalten. |
| LabeledByProperty | Siehe Hinweise. | Ein Kombinationsfeld-Steuerelement hat normalerweise eine statische Textbezeichnung, auf die diese Eigenschaft verweist. |
| LocalizedControlTypeProperty | „Kombinationsfeld“ | Lokalisierte Zeichenfolge für den Steuerelementtyp „CombBox“. |
| NameProperty | Siehe Hinweise. | Das Kombinationsfeld-Steuerelement erhält seinen Namen normalerweise aus einem statischen Textsteuerelement. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von allen Kombinationsfeld-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Hinweise |
|---|---|---|
| IExpandCollapseProvider | Ja | Ein Kombinationsfeld-Steuerelement muss immer eine Dropdownschaltfläche enthalten, damit es ein Kombinationsfeld ist. |
| ISelectionProvider | Ja | Zeigt die aktuelle Auswahl im Kombinationsfeld an. Diese Unterstützung wird an das Listenfeld unter dem Kombinationsfelds delegiert. |
| IValueProvider | Depends (Abhängig) | Wenn das Kombinationsfeld beliebige Textwerte aufnehmen kann, muss das Value-Muster unterstützt werden. Dieses Muster eröffnet die Möglichkeit, den Zeichenfolgeninhalt des Kombinationsfelds programmgesteuert festzulegen. Wenn das Value-Muster nicht unterstützt wird, weist dies darauf hin, dass der Benutzer aus den Listenelementen in der Unterstruktur des Kombinationsfelds auswählen muss. |
| IScrollProvider | Nie | Das Scroll-Muster wird nie direkt für ein Kombinationsfeld unterstützt. Es wird unterstützt, wenn in einem Listenfeld, das in einem Kombinationsfeld enthalten ist, gescrollt werden kann. Es wird möglicherweise nur unterstützt, wenn das Listenfeld auf dem Bildschirm sichtbar ist. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Steuerelementen des Kombinationsfelds unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Support | Notizen |
|---|---|---|
| AutomationFocusChangedEvent | 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 |
| StructureChangedEvent | Erforderlich | Keine |
| Durch geänderteExpandCollapseStateProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteValueProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Wenn das Steuerelement das Value-Muster unterstützt, muss es dieses Ereignis unterstützen. |