Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.
Dieses Thema enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den SplitButton-Steuerelementtyp. Bei der Benutzeroberflächenautomatisierung ist ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty Eigenschaft verwenden zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Baumstruktur der UI Automation, Eigenschaftswerte der UI Automation und Steuermuster.
Mit dem Steuerelement für geteilte Schaltflächen können Sie eine Aktion für ein Steuerelement ausführen und das Steuerelement erweitern, um eine Liste anderer möglicher Aktionen anzuzeigen, die ausgeführt werden können.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den SplitButton-Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Steuerelemente für geteilte Schaltflächen, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms.
Erforderliche UI-Automatisierungsbaumstruktur
In der folgenden Tabelle sind die Steuerelementansicht und die Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur dargestellt, die sich auf geteilte Schaltflächensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
Teilungs-Schaltfläche
|
Teilungs-Schaltfläche - MenuItem (1:n) |
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungs-Eigenschaften aufgeführt, deren Wert oder Definition besonders für Steuerelemente für geteilte Schaltflächen relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierungs-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungseigenschaften für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| AutomationIdProperty | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein. |
| BoundingRectangleProperty | Siehe Hinweise. | Das äußerste Rechteck, das das gesamte Steuerelement enthält. |
| ClickablePointProperty | Siehe Hinweise. | Wird unterstützt, wenn ein umgebendes Rechteck vorhanden ist. Wenn nicht auf jeden Punkt innerhalb des umschließenden Rechtecks geklickt werden kann, und Sie spezielle Treffertests ausführen, setzen Sie die Eigenschaft außer Kraft, und stellen Sie dann einen klickbaren Punkt bereit. |
| IsKeyboardFocusableProperty | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| NameProperty | "Zurück" | Der Name des geteilten Schaltflächensteuerelements wird auf der Schaltfläche angezeigt. |
| LabeledByProperty | Null | Steuerelemente für geteilte Schaltflächen verfügen nicht über eine statische Beschriftung. |
| ControlTypeProperty | Teilungs-Schaltfläche | Dieser Wert ist für alle Benutzeroberflächenframeworks identisch. |
| LocalizedControlTypeProperty | „Unterteilte Schaltfläche“ | Lokalisierte Zeichenfolge, die dem SplitButton-Steuerelementtyp entspricht. |
| HelpTextProperty | Siehe Hinweise. | Der Hilfetext kann auf das Ergebnis der Aktivierung der geteilten Schaltfläche hinweisen, bei der es sich in der Regel um denselben Informationstyp handelt, der über eine QuickInfo dargestellt wird. |
| IsContentElementProperty | Richtig | Das Steuerelement für geteilte Schaltflächen enthält Informationen für den Endbenutzer. |
| IsControlElementProperty | Richtig | Das Steuerelement für geteilte Schaltflächen ist für den Endbenutzer sichtbar. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von geteilten Schaltflächensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
| Steuerelementmuster | Unterstützung | Hinweise |
|---|---|---|
| IInvokeProvider | Erforderlich | Geteilte Schaltflächen weisen immer eine Standardaktion auf, die mit "Invoke" verknüpft ist. |
| IExpandCollapseProvider | Erforderlich | Geteilte Schaltflächen haben immer die Möglichkeit, eine Liste der Optionen zu erweitern. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die von allen Steuerelementen für geteilte Schaltflächen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Unterstützung | Hinweise |
|---|---|---|
| InvokedEvent | Erforderlich | Nichts |
| Durch die BoundingRectangleProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsOffscreenProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsEnabledProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die ExpandCollapseStateProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| AutomationFocusChangedEvent | Erforderlich | Nichts |
| StructureChangedEvent | Erforderlich | Nichts |
Beispiel für das SplitButton-Steuerelement
In der folgenden Abbildung sehen Sie einen SplitButton-Steuerelementtyp in einem DataGrid-Steuerelement.
Die Steuerelementansicht und die Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf das Datenraster und die Steuerelemente für geteilte Schaltflächen bezieht, werden unten angezeigt. Die Steuerelementmuster für jedes Automatisierungselement werden in Klammern angezeigt.
| Benutzeroberflächenautomatisierungsstruktur – Steuerelementansicht | Benutzeroberflächenautomatisierungsstruktur – Inhaltsansicht |
|---|---|
|
|