Benutzeroberflächenautomatisierungs-Unterstützung für den CheckBox-Steuerelementtyp

Artikel
08/10/2011

Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema enthält Informationen über die Microsoft UI Automation-Unterstützung für den CheckBox-Steuerelementtyp. Bei der UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Ein Kontrollkästchen ist ein Objekt, das zum Anzeigen eines Zustands dient, mit dem Benutzer interagieren können, um diesen Zustand zu durchlaufen. Kontrollkästchen bieten dem Benutzer zwei (Ja/Nein, Ein/Aus) oder drei (Ein/Aus/Unbestimmt) Auswahlmöglichkeiten.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den CheckBox-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle CheckBox-Steuerelemente, d. h. für Steuerelemente der Typen Windows Presentation Foundation (WPF), Win32 und Windows Forms.

Dieses Thema enthält folgende Abschnitte.

Erforderliche Benutzeroberflächenautomatisierungs-Struktur
Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
Standardaktion
Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur, die sich auf CheckBox-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
CheckBox	CheckBox

Hinweis
Kontrollkästchen verfügen nie über untergeordnete Elemente im Steuerelement oder in der Inhaltsansicht.Wenn für das Steuerelement untergeordnete Elemente erforderlich sind, sollte ein anderer Steuerelementtyp verwendet werden.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle sind die UI Automation-Eigenschaften aufgelistet, deren Wert oder Definition für CheckBox-Steuerelemente besonders relevant ist. Weitere Informationen über UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-Eigenschaft	Wert	Hinweise
AutomationIdProperty	Siehe Hinweise.	Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.
BoundingRectangleProperty	Siehe Hinweise.	Das äußere Rechteck, welches das gesamte Steuerelement umfasst.
ClickablePointProperty	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 einen speziellen Treffertest ausführen, überschreiben Sie diese Eigenschaft, und geben Sie einen durch Klicken aktivierbaren Punkt an.
ControlTypeProperty	CheckBox	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
IsContentElementProperty	True	Der Wert dieser Eigenschaft muss immer True sein. Das bedeutet, dass das CheckBox-Steuerelement immer in der Inhaltsansicht der UI Automation-Struktur enthalten sein muss.
IsControlElementProperty	True	Der Wert dieser Eigenschaft muss immer True sein. Das bedeutet, dass das CheckBox-Steuerelement immer in der Steuerelementansicht der UI Automation-Struktur enthalten sein muss.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
LabeledByProperty	Null	Kontrollkästchen sind selbstbezeichnend.
LocalizedControlTypeProperty	"Kontrollkästchen"	Lokalisierte Zeichenfolge für den CheckBox-Steuerelementtyp.
NameProperty	Siehe Hinweise.	Der Wert der Name-Eigenschaft eines CheckBox-Steuerelements ist der Text, der neben dem Kästchen angezeigt wird, in dem der Zustand umgeschaltet wird.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle sind die Microsoft UI Automation-Steuerelementmuster aufgelistet, die von allen CheckBox-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster	Unterstützung	Hinweise
IToggleProvider	Erforderlich	Ermöglicht, die internen Zustände des Kontrollkästchens programmgesteuert zu durchlaufen.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die UI Automation-Ereignisse aufgelistet, die von allen CheckBox-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis	Unterstützung	Hinweise
AutomationFocusChangedEvent	Erforderlich	Keine
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine
Durch geänderte ToggleStateProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine

Standardaktion

Als Standardaktion fokussiert das Kontrollkästchen ein Optionsfeld und schaltet dessen aktuellen Status um. Wie oben erwähnt, bieten Kontrollkästchen dem Benutzer zwei (Ja/Nein bzw. Ein/Aus) oder drei (Ein/Aus/Unbestimmt) Auswahlmöglichkeiten. Bei einem Kontrollkästchen mit zwei Auswahlmöglichkeiten besteht die Standardaktion darin, vom Zustand "Ein" in den Zustand "Aus" (bzw. von "Aus" in "Ein") zu wechseln. Bei einem Kontrollkästchen mit drei Auswahlmöglichkeiten durchläuft die Standardaktion die einzelnen Zustände des Kontrollkästchens in einer Reihenfolge, die dem aufeinander folgenden Klicken eines Benutzers auf das Steuerelement entspricht.