Freigeben über

CheckBox-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den CheckBox- Steuerelementtyp.

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 Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den CheckBox- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Kontrollkästchen-Steuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Unterstützung der Benutzeroberflächenautomatisierung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Kontrollkästchen-Steuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • CheckBox
  • CheckBox

 

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für den CheckBox-steuerelementtyp relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußerste Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Wird unterstützt, wenn ein umgebendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umgebenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreiben Und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId CheckBox-
UIA_IsContentElementPropertyId STIMMT Der Wert dieser Eigenschaft muss immer TRUEsein. Dies bedeutet, dass das Kontrollkästchen-Steuerelement immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten sein muss.
UIA_IsControlElementPropertyId STIMMT Der Wert dieser Eigenschaft muss immer TRUEsein. Dies bedeutet, dass das Kontrollkästchen-Steuerelement immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten sein muss.
UIA_IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA_LabeledByPropertyId Null Kontrollkästchen-Steuerelemente sind selbstbeschriftungen.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem CheckBox- Steuerelementtyp entspricht. Der Standardwert ist "Kontrollkästchen" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Wert der IUIAutomationElement::CurrentName (oder CachedName) des Kontrollkästchens ist der Text, der neben dem Feld angezeigt wird, in dem der Umschalterzustand beibehalten wird.

 

Erforderliche 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.

Control Pattern/Pattern-Eigenschaft Support/Wert Notizen
IToggleProvider- Erforderlich Kontrollkästchen unterstützen das Umschalten Steuerelementmusters, damit das Kontrollkästchen programmgesteuert durch seine internen Zustände durchlaufen werden kann.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die Kontrollkästchensteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.

Benutzeroberflächenautomatisierungs-Ereignis Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId Eigenschaftsänderungsereignis.

 

DefaultAction

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 oder 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 durchgibt die Standardaktion die Zustände des Kontrollkästchens in derselben Reihenfolge, als ob der Benutzer aufeinander folgende Mausklicks an das Steuerelement gesendet hatte.

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung