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

Aktualisiert: November 2007

Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den ComboBox-Steuerelementtyp. In der UI-Automatisierung umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen enthalten bestimmte Richtlinien für die UI-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte, Steuerelementmuster und UI-Automatisierung-Ereignisse.

Ein Kombinationsfeld ist ein Listenfeld, das mit einem statischen Steuerelement oder einem Bearbeitungssteuerelement kombiniert ist und das gerade ausgewählte Element im Listenfeldbereich des Kombinationsfelds anzeigt. Der Listenfeldbereich des Steuerelements wird dauerhaft oder nur beim Auswählen des Dropdownpfeils neben dem Steuerelement (der eine Schaltfläche ist) angezeigt. Wenn das Auswahlfeld ein Bearbeitungssteuerelement ist, kann der Benutzer Informationen eingeben, die in der Liste nicht vorhanden sind, andernfalls kann er nur Elemente aus der Liste auswählen.

In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse definiert, die für den ComboBox-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-Anforderungen gelten für alle Kombinationsfeld-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 Ereignisse
  • Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur, die sich auf ComboBox-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

  • ComboBox

    • Bearbeiten (0 oder 1)

    • Liste (1)

    • Listenelement (untergeordnetes Element der Liste; 0 bis viele)

    • Schaltfläche (1)

  • ComboBox

    • 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 z. B. das Kombinationsfeld im Ausführen-Dialogfeld.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle sind die UI-Automatisierung-Eigenschaften aufgelistet, deren Werte oder Definitionen für die Kombinationsfeld-Steuerelemente besonders wichtig sind. Weitere Informationen über 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.

BoundingRectangleProperty

Siehe Hinweise.

Das äußere, das gesamte Steuerelement umfassende Rechteck.

ClickablePointProperty

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.

ControlTypeProperty

ComboBox

Dieser Wert ist für alle Benutzeroberfläche-Frameworks identisch.

HelpTextProperty

Siehe Hinweise.

Der Hilfetext für Kombinationsfeld-Steuerelemente sollte erläutern, warum der Benutzer aufgefordert wird, aus einem Kombinationsfeld mit Optionen auszuwählen. Beispiel: "Durch Auswählen eines Elements in diesem Kombinationsfeld wird die Anzeigeauflösung für den Bildschirm festlegt."

IsContentElementProperty

True

Kombinationsfeld-Steuerelemente sind immer in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten.

IsControlElementProperty

True

Kombinationsfeld-Steuerelemente sind immer in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten.

IsKeyboardFocusableProperty

True

Kombinationsfeld-Steuerelemente machen einen Satz von Elementen eines Auswahlcontainers verfügbar. Das Kombinationsfeld-Steuerelement (ComboBox) kann den Tastaturfokus erhalten. Wenn ein Benutzeroberflächenautomatisierungs-Client den Fokus auf ein Kombinationsfeld setzt, können jedoch ggf. auch alle Elemente in der Teilstruktur des Kombinationsfelds den Fokus erhalten.

LabeledByProperty

Siehe Hinweise.

Kombinationsfeld-Steuerelemente verfügen normalerweise über eine statische Textbezeichnung, auf die diese Eigenschaft verweist.

LocalizedControlTypeProperty

"Kombinationsfeld"

Lokalisierte Zeichenfolge für den ComboBox-Steuerelementtyp.

NameProperty

Siehe Hinweise.

Das Kombinationsfeld-Steuerelement erhält seinen Namen normalerweise aus einem statischen Text-Steuerelement.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle sind die UI-Automatisierung-Steuerelementmuster aufgelistet, die von allen Kombinationsfeld-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

IExpandCollapseProvider

Ja

Ein Kombinationsfeld-Steuerelement muss immer eine Dropdownschaltfläche enthalten, andernfalls handelt es sich nicht um ein Kombinationsfeld.

ISelectionProvider

Ja

Zeigt die aktuelle Auswahl im Kombinationsfeld an. Diese Unterstützung wird an das Listenfeld des Kombinationsfelds delegiert.

IValueProvider

Variabel

Wenn das Kombinationsfeld beliebige Texteingaben akzeptiert, muss das Value-Muster unterstützt werden. Dieses Muster bietet 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 Teilstruktur des Kombinationsfelds auswählen muss.

IScrollProvider

Nie

Das Bildlaufmuster wird nie direkt von einem Kombinationsfeld unterstützt. Es wird unterstützt, wenn ein innerhalb eines Kombinationsfelds enthaltenes Listenfeld einen Bildlauf durchführen kann. Es wird möglicherweise nur unterstützt, wenn das Listenfeld auf dem Bildschirm sichtbar ist.

Erforderliche Ereignisse

In der folgenden Tabelle sind die UI-Automatisierung-Ereignisse aufgelistet, die von allen Kombinationsfeld-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI-Automatisierung-Ereignis

Unterstützung

Hinweise

AutomationFocusChangedEvent

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes BoundingRectangleProperty-Ereignis.

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes IsOffscreenProperty-Ereignis.

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes IsEnabledProperty-Ereignis.

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes ExpandCollapseStateProperty-Ereignis.

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes ValueProperty-Ereignis.

Variabel

Wenn das Steuerelement das Value-Muster unterstützt, muss es dieses Ereignis unterstützen.

Siehe auch

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung

Referenz

ComboBox