Listenfeld (MSAA-UI-Elementreferenz)
Hinweis
In diesem Thema werden List Box-Objekte für zwecke der MSAA-UI-Elementreferenz beschrieben. Das Erstellen von Listenfeldobjekten in verschiedenen Benutzeroberflächenframeworks ist hier nicht beschrieben. Informationen zum verwendeten BENUTZERoberflächenframework finden Sie in der API-Referenzdokumentation.
Listenfelder zeigen eine Liste an, aus der ein Benutzer ein oder mehrere Elemente auswählen kann. Ein Listenfeld wird mit einer vertikalen Bildlaufleiste, einer horizontalen Steuerleiste oder beidem erstellt.
Der Name der Fensterklasse für ein Listenfeld lautet "LISTBOX".
IAccessible-Methoden
Listenfelder unterstützen die folgenden IAccessible-Methoden :
| Methode | Kommentare |
|---|---|
| accDoDefaultAction | Das Listenfeldobjekt selbst verfügt nicht über eine DefaultAction-Eigenschaft . accDoDefaultAction doppelt klickt jedoch auf Listenfeldelemente. |
| accHitTest | Die accHitTest-Methode gibt null zurück, wenn sich der getestete Punkt innerhalb des Listenfelds befindet, aber nicht für ein Element im Listenfeld. Wenn sich der getestete Punkt auf einem Element im Listenfeld befindet, gibt accHitTest den Index des Listenfeldelements zurück. |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible-Eigenschaften
Listenfelder unterstützen die folgenden IAccessible-Eigenschaften :
| Eigenschaft | Kommentare |
|---|---|
| get_accChild | Die ChildCount-Eigenschaft ist die Anzahl der Elemente im Listenfeld. |
| get_accDefaultAction | Das Listenfeldobjekt selbst verfügt nicht über eine DefaultAction-Eigenschaft . Die DefaultAction-Eigenschaft für jedes Listenelement ist jedoch "Doppelklick". |
| get_accDescription | |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | Die KeyboardShortcut-Eigenschaft ist die Zugriffstaste des Listenfelds, bei der es sich um ein unterstrichenes Zeichen im Text der Bezeichnung handelt, die dem Listenfeld zugeordnet ist. Die zurückgegebene Zeichenfolge enthält das Zugriffstastenzeichen, das an die Zeichenfolge "ALT+" angefügt ist. |
| get_accName | Die Name-Eigenschaft für das Listenfeldobjekt ist der Text aus einem statischen Textsteuerelement, das das Listenfeld beschriftt. Für die Listenfeldelemente ist die Name-Eigenschaft der Text des Listenelements. |
| get_accParent | Die Parent-Eigenschaft ist ein Fenster ( ROLE_SYSTEM_WINDOW ), das das Listenfeld umgibt und dieselbe Name-Eigenschaft und den gleichen Fensterklassennamen wie das Listenfeld aufweist. Die Parent-Eigenschaft der Listenfeldelemente ist das Listenfeldobjekt. |
| get_accRole | Die Role-Eigenschaft ist ROLE_SYSTEM_LIST. Die Elemente im Listenfeld weisen die Role-EigenschaftROLE_SYSTEM_LISTITEM auf. |
| get_accSelection | Die Selection-Eigenschaft ruft die ausgewählten Elemente im Listenfeld ab. |
| get_accState | Die State-Eigenschaft des Listenfeldobjekts ist eine Kombination aus mindestens einem der folgenden Werte: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_FOCUSED | | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN Die State-Eigenschaft des Listenfeldelements ist eine Kombination aus einem oder mehreren der folgenden Werte: | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_OFFSCREEN STATE_SYSTEM_NORMAL |