Kontrollkästchen (MSAA-UI-Elementreferenz)
Hinweis
In diesem Thema werden Kontrollkästchenobjekte für Zwecke der MSAA-Ui-Elementreferenz beschrieben. Wie Sie Kontrollkästchenobjekte in verschiedenen Benutzeroberflächenframeworks erstellen, wird hier nicht beschrieben. Weitere Informationen finden Sie in der API-Referenzdokumentation für das von Ihnen verwendete Benutzeroberflächenframework.
Kontrollkästchen werden verwendet, um ein oder mehrere Features oder Optionen aus einer Gruppe zu aktivieren oder zu deaktivieren, normalerweise innerhalb eines Dialogfelds. In der Regel enthält ein Kontrollkästchen ein kleines Kontrollkästchen mit angrenzendem Text. Wenn eine Option ausgewählt ist, wird im Feld ein Häkchen angezeigt.
Der Fensterklassenname für ein Kontrollkästchen lautet "BUTTON".
IAccessible-Methoden
Kontrollkästchen unterstützen die folgenden IAccessible-Methoden :
| Methode | Kommentare |
|---|---|
| accDoDefaultAction | Die accDoDefaultAction-Methode ruft PostMessage mit der BM_CLICK Schaltflächennachricht auf, um auf das Kontrollkästchen zu klicken. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible-Eigenschaften
Kontrollkästchen unterstützen die folgenden IAccessible-Eigenschaften :
| Eigenschaft | Kommentare |
|---|---|
| get_accChild | |
| get_accChildCount | Die ChildCount-Eigenschaft ist 0. |
| get_accDefaultAction | Die DefaultAction-Eigenschaft eines Kontrollkästchens hängt davon ab, ob es aktiviert ist. Ein Kontrollkästchen, das nicht aktiviert ist, weist "Check" als DefaultAction auf, und ein aktiviertes Kontrollkästchen weist "Deaktivieren" als DefaultAction auf. Das Kontrollkästchen DefaultAction für drei Status lautet "Umschalten". |
| get_accDescription | |
| accFocus | |
| accKeyboardShortcut | Die KeyboardShortcut-Eigenschaft ist die Zugriffstaste des Kontrollkästchens, die ein unterstrichenes Zeichen im Fenstertext des Steuerelements ist. Diese Zeichenfolge enthält das Zugriffstastenzeichen, das an die Zeichenfolge "ALT+" angefügt ist. |
| accHelp | Die Name-Eigenschaft wird aus dem Fenstertext des Steuerelements (oder Untertitel) abgerufen, der mit dem Kontrollkästchen angezeigt wird. |
| accHelpTopic | |
| accName | Die Name-Eigenschaft wird aus dem Fenstertext des Steuerelements (oder Untertitel) abgerufen, der mit dem Kontrollkästchen angezeigt wird. |
| accParent | Die Parent-Eigenschaft ist ein Fenster ( ROLE_SYSTEM_WINDOW ), das das Steuerelement umgibt und denselben Name-Eigenschafts- und Fensterklassennamen wie das Steuerelement aufweist. |
| accRole | Die Role-Eigenschaft ist ROLE_SYSTEM_CHECKBUTTON. |
| accState | Die State-Eigenschaft ist eine Kombination aus mindestens einem der folgenden Werte:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED STATE_SYSTEM_FOCUSABLE | | STATE_SYSTEM_MIXED | STATE_SYSTEM_CHECKED | STATE_SYSTEM_NORMAL |