Benutzeroberflächenautomatisierungs-Unterstützung für den Schaltflächen-Steuerelementtyp
Aktualisiert: November 2007
Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den Button-Steuerelementtyp. In UI-Automatisierung umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen enthalten bestimmte Richtlinien für UI-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte, Steuerelementmuster und UI-Automatisierung-Ereignisse.
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ächen-Steuerelement wird auf einfache Weise verfügbar gemacht, da es einem bestimmten Befehl zugeordnet ist, den der Benutzer ausführen möchte.
In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse definiert, die für den Schaltflächen-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-Anforderungen gelten für alle Schaltflächen-Steuerelemente, seien dies Windows Presentation Foundation (WPF)-, Win32- oder Windows Forms-Steuerelemente.
Dieses Thema enthält folgende Abschnitte.
- Erforderliche Benutzeroberflächenautomatisierungs-Struktur
- Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
- Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
- Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
- Verwandte Abschnitte
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur für Button-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
|
|
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle werden die UI-Automatisierung-Eigenschaften aufgelistet, deren Wert oder Definition für die Steuerelemente besonders relevant ist, die den Schaltflächen-Steuerelementtyp implementieren (wie z. B. Schaltflächen-Steuerelemente). Weitere Informationen über die UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
UI-Automatisierung-Eigenschaft |
Wert |
Hinweise |
|---|---|---|
Siehe Hinweise. |
Das Schaltflächen-Steuerelement muss in der Regel eine Tastenkombination unterstützen, damit Endbenutzer die durch das Steuerelement dargestellte Aktion schnell über die Tastatur ausführen können. |
|
AutomationIdProperty() |
Siehe Hinweise. |
Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein. |
Siehe Hinweise. |
Das äußere Rechteck, welches das gesamte Steuerelement umfasst. |
|
Siehe Hinweise. |
Unterstützt, wenn ein umschließendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks durch Klicken aktiviert werden kann und Sie eine spezielle Trefferprüfung ausführen, setzen Sie diese Eigenschaft außer Kraft, und geben Sie einen durch Klicken aktivierbaren Punkt an. |
|
Schaltfläche |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
Siehe Hinweise. |
Der Hilfetext sollte angeben, welches Ergebnis durch Aktivieren der Schaltfläche erreicht wird. Diese Informationen müssen durch eine QuickInfo verfügbar gemacht werden. |
|
True |
Das Schaltflächen-Steuerelement muss stets ein Inhaltselement sein. |
|
True |
Das Schaltflächen-Steuerelement muss stets ein Steuerelement sein. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
Null |
Schaltflächen-Steuerelemente haben aufgrund ihres Inhalts eine Eigenbezeichnung. |
|
"Schaltfläche" |
Lokalisierte Zeichenfolge, die dem Schaltflächen-Steuerelementtyp entspricht. |
|
Siehe Hinweise. |
Der Name des Schaltflächen-Steuerelements ist der Text, mit dem es beschriftet wird. Wenn ein Bild zum Bezeichnen einer Schaltfläche verwendet wird, muss für die Name-Eigenschaft der Schaltfläche ein Alternativtext angegeben werden. |
Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
In der folgenden Tabelle werden die UI-Automatisierung-Steuerelementmuster aufgelistet, die von allen Schaltflächen-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.
Steuerelementmuster/Mustereigenschaft |
Unterstützung/Wert |
Hinweise |
|---|---|---|
Siehe Hinweise. |
Alle Schaltflächen müssen das Invoke-Steuerelementmuster oder das Toggle-Steuerelementmuster unterstützen. Invoke wird unterstützt, wenn die Schaltfläche auf Anforderung des Benutzers einen Befehl ausführt. Dieser Befehl wird einem einzelnen Vorgang zugeordnet, z. B. Ausschneiden, Kopieren, Einfügen oder Löschen. |
|
Siehe Hinweise. |
Alle Schaltflächen müssen das Invoke-Steuerelementmuster oder das Toggle-Steuerelementmuster unterstützen. Toggle wird unterstützt, wenn die Schaltfläche maximal drei Zustände durchlaufen kann. In der Regel ist dies als Ein-/Ausschalter für bestimmte Features realisiert. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle werden die UI-Automatisierung-Ereignisse aufgelistet, die von allen Schaltflächen-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.
UI-Automatisierung-Ereignis |
Unterstützung |
Hinweise |
|---|---|---|
Erforderlich |
Keine |
|
Durch Eigenschaft ausgelöstes geänderte BoundingRectangleProperty-Ereignis. |
Erforderlich |
Keine |
Durch geänderte Eigenschaft ausgelöstes IsOffscreenProperty-Ereignis. |
Erforderlich |
Keine |
Durch geänderte Eigenschaft ausgelöstes IsEnabledProperty-Ereignis. |
Erforderlich |
Keine |
Durch geänderte Eigenschaft ausgelöstes NameProperty-Ereignis. |
Erforderlich |
Keine |
Erforderlich |
Keine |
|
Variabel |
Wenn das Steuerelement das Invoke-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
|
Durch geänderte Eigenschaft ausgelöstes ToggleStateProperty-Ereignis. |
Variabel |
Wenn das Steuerelement das Toggle-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
Siehe auch
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung
Übersicht über die Benutzeroberflächenautomatisierung