Benutzeroberflächenautomatisierungs-Unterstützung für den CheckBox-Steuerelementtyp
Aktualisiert: November 2007
Dieses Thema enthält Informationen über die Microsoft-UI-Automatisierung-Unterstützung für den CheckBox-Steuerelementtyp. Bei der UI-Automatisierung 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-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte 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-Automatisierung-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den CheckBox-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-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-Automatisierung-Struktur, die sich auf CheckBox-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
|
|
.gif "Hinweis") 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-Automatisierung-Eigenschaften aufgelistet, deren Wert oder Definition für CheckBox-Steuerelemente besonders relevant ist. Weitere Informationen über UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
UI-Automatisierung-Eigenschaft |
Wert |
Hinweise |
|---|---|---|
AutomationIdProperty() |
Siehe Hinweise. |
Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein. |
Siehe Hinweise. |
Das äußere, das gesamte Steuerelement umfassende Rechteck. |
|
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, überschreiben Sie diese Eigenschaft, und geben Sie einen durch Klicken aktivierbaren Punkt an. |
|
CheckBox |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
True |
Der Wert dieser Eigenschaft muss immer True sein. Das bedeutet, dass das CheckBox-Steuerelement immer in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten sein muss. |
|
True |
Der Wert dieser Eigenschaft muss immer True sein. Das bedeutet, dass das CheckBox-Steuerelement immer in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten sein muss. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
Null |
Kontrollkästchen sind selbstbezeichnend. |
|
"Kontrollkästchen" |
Lokalisierte Zeichenfolge für den CheckBox-Steuerelementtyp. |
|
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-Automatisierung-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/Mustereigenschaft |
Unterstützung/Wert |
Hinweise |
|---|---|---|
Erforderlich |
Ermöglicht, die internen Zustände des Kontrollkästchens programmgesteuert zu durchlaufen. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die UI-Automatisierung-Ereignisse aufgelistet, die von allen CheckBox-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 geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis. |
Erforderlich |
Nein |
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis. |
Erforderlich |
Keine |
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis. |
Erforderlich |
Keine |
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.
Siehe auch
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung
Übersicht über die Benutzeroberflächenautomatisierung