Freigeben über

Unterstützung der Benutzeroberflächenautomatisierung für den CheckBox-Steuerelementtyp

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 Microsoft-Benutzeroberflächenautomatisierung für den CheckBox-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.

Ein Kontrollkästchen ist ein Objekt, das verwendet wird, um einen Zustand anzugeben, mit dem Benutzer interagieren können, um diesen Zustand zu durchlaufen. Kontrollkästchen stellen dem Benutzer entweder eine binäre Option (Ja/Nein), (Ein/Aus) oder tertiäre Option (Ein, Aus, unbestimmt) dar.

In den folgenden Abschnitten werden die erforderliche Automatisierungsstruktur der Benutzeroberfläche, die Eigenschaften, die Steuerelementmuster und die Ereignisse für den CheckBox-Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Kontrollkästchen-Steuerelemente, 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 Kontrollkästchensteuerelemente bezieht und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungs-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungsstruktur.

Steuerelementansicht Inhaltsansicht
Kontrollkästchen Kontrollkästchen

Hinweis

Kontrollkästchen haben keine untergeordnete Elemente in der Steuerelement- oder Inhaltsansicht. Wenn das Steuerelement untergeordnete Elemente enthalten muss, bedeutet dies, dass ein anderer Steuerelementtyp verwendet werden muss.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Kontrollkästchensteuerelemente 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.
ControlTypeProperty Kontrollkästchen Dieser Wert ist für alle Benutzeroberflächenframeworks identisch.
IsContentElementProperty Richtig Diese Eigenschaft muss immer den Wert „True“ haben. Dies bedeutet, dass das Kontrollkästchen-Steuerelement immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten sein muss.
IsControlElementProperty Richtig Diese Eigenschaft muss immer den Wert „True“ haben. Dies bedeutet, dass das Kontrollkästchen-Steuerelement immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-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 selbstbeschriftende Steuerelemente.
LocalizedControlTypeProperty „Kontrollkästchen“ Lokalisierte Zeichenfolge, die dem CheckBox-Steuerelementtyp entspricht.
NameProperty Siehe Hinweise. Der Wert der Name -Eigenschaft des Kontrollkästchen-Steuerelements ist der Text, der neben dem Feld angezeigt wird, das den Umschaltzustand kennzeichnet.

Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Kontrollkästchen-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Steuerelementmuster Unterstützung Hinweise
IToggleProvider Erforderlich Ermöglicht, dass der interne Zustand des Kontrollkästchens programmgesteuert durchlaufen werden kann.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die von allen Kontrollkästchen-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter "Übersicht über Benutzeroberflächenautomatisierungsereignisse".

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
StructureChangedEvent Erforderlich Nichts
Durch die ToggleStateProperty-Eigenschaft geändertes Ereignis. Erforderlich Nichts

Standardaktion

Die Standardaktion des Kontrollkästchens besteht darin, dass ein Optionsfeld fokussiert wird und den aktuellen Zustand umschalten kann. Wie bereits erwähnt, stellen Kontrollkästchen entweder eine binäre Entscheidung (Ja/Nein) (Ein/Aus) für den Benutzer oder eine tertiäre Entscheidung (Ein, Aus, Unbestimmt) dar. Wenn das Kontrollkästchen binär ist, bewirkt die Standardaktion, dass der Zustand "Ein" oder der "Aus"-Zustand "ein" wird. In einem tertiären Kontrollkästchen bewirkt die Standardaktion, dass der Zustand des Kontrollkästchens so durchlaufen wird, als hätte der Benutzer aufeinanderfolgende Mausklicks an das Steuerelement gesendet.

Siehe auch