Freigeben über

ComboBox-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung des ComboBox-Steuerelementtyps von Microsoft 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 erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ComboBox-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Kombinationsfeldsteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Benutzeroberflächenplattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur der Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Kombinationsfeldsteuerelemente 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
  • Kombinationsfeld
    • Bearbeitung (0 oder 1)
    • Liste (0 oder 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 eingaben zu können, wie dies im Kombinationsfeld im Dialogfeld Ausführen der Fall ist.

Relevante Eigenschaften

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

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 begrenzungsenden Rechtecks geklickt werden kann und das Element spezielle Treffertests ausführt, überschreiben Sie, und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId Kombinationsfeld
UIA_HelpTextPropertyId Siehe Hinweise. Der Hilfetext für Kombinationsfeldsteuerelemente sollte erläutern, warum der Benutzer aufgefordert wird, eine Option aus dem 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.“
UIA_IsContentElementPropertyId TRUE Kombinationsfeld-Steuerelemente sind immer in der Inhaltsansicht der UI Automatisierungsstruktur enthalten.
UIA_IsControlElementPropertyId TRUE Kombinationsfeld-Steuerelemente sind immer in der Inhaltsansicht der UI Automatisierungsstruktur enthalten.
UIA_IsKeyboardFocusablePropertyId TRUE Kombinationsfeldsteuerelemente können den Tastaturfokus erhalten; Wenn jedoch ein Benutzeroberflächenautomatisierung Client den Fokus auf ein Kombinationsfeld festlegt, kann jedes Element in der Unterstruktur des Kombinationsfelds den Fokus erhalten.
UIA_LabeledByPropertyId Siehe Hinweise. Ein Kombinationsfeld-Steuerelement hat normalerweise eine statische Textbezeichnung, auf die diese Eigenschaft verweist.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem ComboBox-Steuerelementtyp 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 Textbeschriftung vorhanden ist, müssen Sie der Name-Eigenschaft einen Wert zuweisen. Die Name-Eigenschaft sollte niemals den aktuellen Inhalt des Kombinationsfelds enthalten oder sich ändern, wenn sich der Inhalt des Kombinationsfelds ändert.

 

Erforderliche 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 Erforderlich Das ExpandCollapse-Steuerelementmuster muss unterstützt werden, da ein Kombinationsfeld-Steuerelement immer eine Dropdownschaltfläche enthalten muss.
ISelectionProvider Depends (Abhängig) Zeigt die aktuelle Auswahl im Kombinationsfeld an. Die Unterstützung für das Auswahl-Steuerelementmuster wird an das Listenfeld unterhalb des Kombinationsfelds delegiert, ist aber möglicherweise nicht immer möglich.
IValueProvider Depends (Abhängig) Wenn das Kombinationsfeld beliebige Textwerte annehmen kann, muss das Wert-Steuerelementmuster 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 in der Unterstruktur des Kombinationsfelds auswählen.
IScrollProvider Nie Das Scroll-Steuerelementmuster 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ächenautomatisierung Ereignisse aufgeführt, die Kombinationsfeldsteuerelemente 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_StructureChangedEventId
UIA_ExpandCollapseExpandCollapseStatePropertyId Eigenschaft geändertes Ereignis.
UIA_ValueValuePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Value-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung