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
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Beispiel für den SplitButton-Steuerelementtyp
- Zugehörige Themen
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 |
|---|---|
|
|
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.
| Benutzeroberflächenautomatisierung Struktur – Steuerungsansicht | Benutzeroberflächenautomatisierung Struktur – Inhaltsansicht |
|---|---|
|
|
Zugehörige Themen