Freigeben über


SplitButton-Steuerelementtyp

Dieses Thema enthält Informationen zur Unterstützung des SplitButton-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.

Das Steuerelement für geteilte Schaltflächen ermöglicht das Ausführen einer Aktion für ein Steuerelement und das Erweitern des Steuerelements, um eine Liste mit anderen möglichen Aktionen anzuzeigen, die ausgeführt werden können.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den SplitButton-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Steuerelemente für geteilte Schaltflächen, bei denen das Ui-Framework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur, die sich auf Steuerelemente mit geteilten Schaltflächen 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
  • SplitButton
    • Bild (0 oder 1)
    • Text (0 oder 1)
    • Button (1 oder 2)
      • Menü (0 oder 1; wird als untergeordnetes Element einer Unterschaltfläche angezeigt, die das ExpandCollapse-Muster unterstützt)
        • MenuItem (1:n)
  • SplitButton
    • Button (1 oder 2)
      • MenuItem (1:n)

 

Relevante Eigenschaften

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

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 umgebenden Rechtecks geklickt werden kann, und das Element spezielle Treffertests durchführt, überschreiben Sie es, und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId SplitButton Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
UIA_HelpTextPropertyId Siehe Hinweise. Der Hilfetext kann das Ergebnis der Aktivierung der unterteilten Schaltfläche angeben. Hierbei handelt es sich in der Regel um dieselben Informationen, die durch ein QuickInfo angezeigt werden.
UIA_IsContentElementPropertyId TRUE Das Steuerelement für eine unterteilte Schaltfläche enthält Informationen für den Endbenutzer.
UIA_IsControlElementPropertyId TRUE Das Steuerelement für eine unterteilte Schaltfläche ist für den Endbenutzer sichtbar.
UIA_IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA_LabeledByPropertyId NULL Steuerelemente für unterteilte Schaltflächen verfügen nicht über eine statische Textbezeichnung.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem SplitButton-Steuerelementtyp entspricht. Der Standardwert ist "Geteilte Schaltfläche" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Text, der zum Beschriften der geteilten Schaltfläche verwendet wird. Wenn ein Bild zum Beschriften einer geteilten Schaltfläche verwendet wird, muss alternativer Text für die Eigenschaft Name der geteilten Schaltfläche angegeben werden.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von allen Steuerelementen für geteilte Schaltflächen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster Support Hinweise
IExpandCollapseProvider Erforderlich Da geteilte Schaltflächen immer die Möglichkeit haben, eine Liste von Optionen zu erweitern, müssen sie das ExpandCollapse-Steuerelementmuster unterstützen.
IInvokeProvider Erforderlich Da geteilte Schaltflächen immer über eine Standardaktion verfügen, die der IInvokeProvider::Invoke-Methode zugeordnet ist, müssen sie das Invoke-Steuerelementmuster unterstützen.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die geteilte Schaltflächensteuerelemente 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_ExpandCollapseExpandCollapseStatePropertyId Eigenschaft geändertes Ereignis.
UIA_Invoke_InvokedEventId
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

 

Beispiel für den SplitButton-Steuerelementtyp

Die folgende Abbildung veranschaulicht ein Steuerelement, das den SplitButton-Steuerelementtyp implementiert.

Screenshot: Beispiel für ein Splitbutton-Steuerelement

Benutzeroberflächenautomatisierung Struktur – Steuerungsansicht Benutzeroberflächenautomatisierung Struktur – Inhaltsansicht
  • SplitButton „Name“ (Invoke, ExpandCollapse)
    • Schaltfläche "Mehr Option" (Aufrufen)
      • Menü
        • MenuItem
        • ...
  • SplitButton „Name“ (Invoke, ExpandCollapse)
    • Schaltfläche "Mehr Option" (Aufrufen)
      • Menü
        • MenuItem
        • ...

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung