Freigeben über

ComboBox-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den ComboBox- Steuerelementtyp.

Ein Kombinationsfeld ist ein Listenfeld, das mit einem statischen Steuerelement oder einem Bearbeitungssteuerelement kombiniert wird, das das aktuell ausgewählte Element im Listenfeldteil des Kombinationsfelds anzeigt. Der Listenfeldteil des Steuerelements wird immer angezeigt oder wird nur angezeigt, wenn der Benutzer den Dropdownpfeil (ein Knopfdruck) neben dem Steuerelement auswählt. Wenn das Auswahlfeld ein Bearbeitungssteuerelement ist, kann der Benutzer Informationen eingeben, die sich nicht in der Liste befinden. andernfalls kann der Benutzer nur Elemente in der Liste auswählen.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ComboBox- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Kombinationsfeld-Steuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Unterstützung der Benutzeroberflächenautomatisierung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Kombinationsfeld-Steuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • ComboBox
    • Bearbeiten (0 oder 1)
    • Liste (0 oder 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 eingaben zu können, wie im Fall des Kombinationsfelds im Dialogfeld Ausführen.

Relevante Eigenschaften

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

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußerste Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Wird unterstützt, wenn ein umgebendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umgebenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreiben Und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId ComboBox
UIA_HelpTextPropertyId Siehe Hinweise. Der Hilfetext für Kombinationsfeld-Steuerelemente sollte erläutern, warum der Benutzer gefragt wird, ob im Kombinationsfeld eine Option ausgewählt wird. Der Text ähnelt informationen, die über eine QuickInfo dargestellt werden. Beispiel: "Wählen Sie ein Element aus, um die Anzeigeauflösung Ihres Monitors festzulegen."
UIA_IsContentElementPropertyId STIMMT Kombinationsfeld-Steuerelemente sind immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId STIMMT Kombinationsfeld-Steuerelemente sind immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsKeyboardFocusablePropertyId STIMMT Kombinationsfeld-Steuerelemente können den Tastaturfokus erhalten; Wenn ein Benutzeroberflächenautomatisierungs-Client jedoch den Fokus auf ein Kombinationsfeld festlegt, kann jedes Element in der Unterstruktur des Kombinationsfelds den Fokus erhalten.
UIA_LabeledByPropertyId Siehe Hinweise. Kombinationsfeld-Steuerelemente weisen in der Regel eine statische Textbeschriftung auf, auf die diese Eigenschaft verweist.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem steuerelementtyp ComboBox entspricht. Der Standardwert ist "Kombinationsfeld" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Name des Kombinationsfeld-Steuerelements wird in der Regel aus einer statischen Textbezeichnung generiert. Wenn keine statische Beschriftung vorhanden ist, müssen Sie der Eigenschaft Name einen Wert zuweisen. Die eigenschaft Name sollte niemals den aktuellen Inhalt des Kombinationsfelds enthalten oder sich ändern, wenn sich der Inhalt des Kombinationsfelds ändert.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Kombinationsfeld-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Steuerelementmuster Unterstützen Notizen
IExpandCollapseProvider Erforderlich Das ExpandCollapse Steuerelementmusters muss unterstützt werden, da ein Kombinationsfeld-Steuerelement immer eine Dropdownschaltfläche enthalten muss.
ISelectionProvider- Hängt Zeigt die aktuelle Auswahl im Kombinationsfeld an. Die Unterstützung für das Auswahl- Steuerelementmusters wird an das Listenfeld unterhalb des Kombinationsfelds delegiert, ist aber möglicherweise nicht immer machbar.
IValueProvider- Hängt Wenn das Kombinationsfeld beliebige Textwerte übernehmen kann, muss das Wert- Steuerelementmusters unterstützt werden. Mit diesem Muster kann der Zeichenfolgeninhalt des Kombinationsfelds programmgesteuert festgelegt werden. Wenn das Wert-Steuerelementmuster nicht unterstützt wird, muss der Benutzer aus den Listenelementen innerhalb der Unterstruktur des Kombinationsfelds auswählen.
IScrollProvider- Nie Das Bildlauf- Steuerelementmusters wird nie direkt in einem Kombinationsfeld unterstützt. Es wird unterstützt, wenn ein Listenfeld, das in einem Kombinationsfeld enthalten ist, scrollen kann, und nur, wenn das Listenfeld auf dem Bildschirm sichtbar ist.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungs-Ereignisse aufgeführt, die Kombinationsfeld-Steuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.

Benutzeroberflächenautomatisierungs-Ereignis Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden.
UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_StructureChangedEventId
UIA_ExpandCollapseExpandCollapseStatePropertyId Eigenschaftsänderungsereignis.
UIA_ValueValuePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Wert- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

 

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung