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 Schaltflächen-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. Die Bedingungen beinhalten spezifische Richtlinien für die UI Automation-Baumstruktur, UI-Automatisierungseigenschaftswerte, Steuerungsmuster und UI-Automatisierungsereignisse.
Eine Schaltfläche ist ein Objekt, mit dem ein Benutzer interagiert, um eine Aktion auszuführen, z. B. die Schaltflächen "OK " und " Abbrechen " in einem Dialogfeld. Das Schaltflächensteuerelement ist ein einfaches Steuerelement, das verfügbar gemacht werden kann, da es einem einzelnen Befehl zugeordnet ist, den der Benutzer abschließen möchte.
In den folgenden Abschnitten wird die erforderliche UI-Automatisierungsbaumstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp "Button" definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Schaltflächensteuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms.
Erforderliche UI-Automatisierungsbaumstruktur
Die folgende Tabelle zeigt die Steuerelementansicht und die Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf 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 |
|---|---|
| Schaltfläche - Bild (0 oder mehr) - Text (0 oder mehr) |
Schaltfläche |
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für die Steuerelemente relevant ist, die den Steuerelementtyp "Button" implementieren (z. B. Schaltflächensteuerelemente). Weitere Informationen zu Benutzeroberflächenautomatisierungs-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungseigenschaften für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| AcceleratorKeyProperty | Siehe Hinweise. | Das Schaltflächen-Steuerelement muss in der Regel eine Tastenkombination unterstützen, damit ein Endbenutzer die Aktion, der das Steuerelement entspricht, schnell über die Tastatur ausführen kann. |
| 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. |
| ControlTypeProperty | Schaltfläche | Dieser Wert ist für alle Benutzeroberflächenframeworks identisch. |
| HelpTextProperty | Siehe Hinweise. | Der Hilfetext kann angeben, was das Endergebnis der Aktivierung der Schaltfläche ist. Hierbei handelt es sich in der Regel um dieselben Informationen, wie sie über eine QuickInfo angezeigt werden. |
| IsContentElementProperty | Richtig | Das Schaltflächensteuerelement muss immer mit Inhalt versehen sein. |
| IsControlElementProperty | Richtig | Das Schaltflächen-Steuerelement muss immer ein Steuerelement sein. |
| IsKeyboardFocusableProperty | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| LabeledByProperty | Null |
Schaltflächensteuerelemente werden von ihren Inhalten selbst beschriftet. |
| LocalizedControlTypeProperty | „Schaltfläche“ | Lokalisierte Zeichenfolge, die dem Steuerelementtyp "Button" entspricht. |
| NameProperty | Siehe Hinweise. | Der Name des Schaltflächensteuerelements ist der Text, der zum Bezeichnen des Steuerelements verwendet wird. Jedes Mal, wenn ein Bild zum Bezeichnen einer Schaltfläche verwendet wird, muss alternativer Text für die Name-Eigenschaft der Schaltfläche angegeben werden. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen 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 | Siehe Hinweise. | Alle Schaltflächen sollten das "Invoke"-Steuerungsmuster oder das "Toggle"-Steuerungsmuster unterstützen. Der Aufruf wird unterstützt, wenn die Schaltfläche einen Befehl auf Anforderung des Benutzers ausführt. Dieser Befehl ordnet einem einzelnen Vorgang wie "Ausschneiden", "Kopieren", "Einfügen" oder "Löschen" zu. |
| IToggleProvider | Siehe Hinweise. | Alle Schaltflächen sollten das "Invoke"-Steuerungsmuster oder das "Toggle"-Steuerungsmuster unterstützen. Toggle wird unterstützt, wenn die Schaltfläche eine Reihe von maximal drei Zuständen durchlaufen kann. Dies wird in der Regel als Ein/Aus-Schalter für bestimmte Features angesehen. |
| IExpandCollapseProvider | Siehe Hinweise. | Wird eine Schaltfläche als untergeordnete Schaltfläche einer unterteilten Schaltfläche gehostet, kann die untergeordnete Schaltfläche anstelle des Invoke- oder Toggle-Musters das ExpandCollapse-Muster unterstützen. Das ExpandCollapse-Muster kann zum Öffnen oder Schließen eines Menüs oder einer anderen Unterstruktur verwendet werden, die dem Schaltflächenelement zugeordnet ist. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die von allen Schaltflächensteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Unterstützung | Hinweise |
|---|---|---|
| AutomationFocusChangedEvent | 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 NameProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| StructureChangedEvent | Erforderlich | Nichts |
| InvokedEvent | Hängt | Wenn das Steuerelement das Invoke-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| Durch die ToggleStateProperty-Eigenschaft geändertes Ereignis. | Hängt | Wenn das Steuerelement das Umschaltsteuerungsmuster unterstützt, muss es dieses Ereignis unterstützen. |