List-View-Steuerelement (MSAA UI-Elementreferenz)
Anmerkung
In diesem Thema werden List-View Control-Objekte für MSAA-UI-Elementreferenzen beschrieben. Hier wird nicht beschrieben, wie sie List-View Steuerelement- Objekte in verschiedenen Benutzeroberflächenframeworks erstellen. Weitere Informationen finden Sie in der API-Referenzdokumentation für das von Ihnen verwendete Benutzeroberflächenframework.
Ein Listenansichtssteuerelement zeigt eine Sammlung von Elementen an, die jeweils aus einem Symbol und einer Beschriftung bestehen, und bietet mehrere Möglichkeiten zum Anzeigen und Anordnen der Elemente. Beispielsweise werden zusätzliche Informationen zu jedem Element rechts neben dem Symbol und der Beschriftung in Spalten angezeigt. Windows Explorer verwendet ein Listenansichtssteuerelement zum Anzeigen von Dateien.
Der Name der Fensterklasse für ein Listenansicht-Steuerelement ist WC_LISTVIEW, das in "Commctrl.h" als "SysListView" definiert ist.
IAccessible-Methoden
Ein Listenansicht-Steuerelement unterstützt die folgenden IAccessible Methoden:
| Methode | Kommentare |
|---|---|
| accDoDefaultAction | Das Listenansichtsobjekt selbst verfügt nicht über eine DefaultAction-eigenschaft; die accDoDefaultAction Methode doppelklickt jedoch auf Listenansichtselemente. |
| accHitTest- | |
| accLocation- | |
| accNavigate- | |
| accSelect- |
IAccessible-Eigenschaften
Ein Listenansichtssteuerelement unterstützt die folgenden IAccessible Eigenschaften:
| Eigentum | Kommentare |
|---|---|
| get_accChild | |
| get_accChildCount | Die eigenschaft ChildCount ist die Anzahl der Elemente in der Liste. |
| get_accDefaultAction | Das Listenansichtsobjekt selbst verfügt nicht über eine DefaultAction-eigenschaft; Die DefaultAction-Eigenschaft für jedes Listenansichtselement lautet jedoch "Double Click". |
| get_accDescription | Das Listenansichtsobjekt selbst unterstützt die Description-Eigenschaft nicht; Die Description-Eigenschaft für jedes Listenansichtselement ist jedoch der Text, der in den zweiten und nachfolgenden Spalten des Elements enthalten ist. Zwischen dem Text für jede Spalte wird ein Komma eingefügt. |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | Listenansichtsobjekte verfügen nicht über Tastenkombinationen. Wenn der Fenstertext für das Listenansicht-Steuerelement jedoch ein kaufmännisches und- (&)-Zeichen enthält, gibt Microsoft Active Accessibility eine Zeichenfolge ohne Null als KeyboardShortcut-Eigenschaft zurück. |
| get_accName | Der Name für das Listenansichtsobjekt wird aus dem Fenstertext (oder der Beschriftung) des Steuerelements abgerufen. Dieser Text wird nicht mit dem Listenansichtssteuerelement angezeigt, sodass Serverentwickler aussagekräftigen Text in der Ressourcendefinitionsanweisung des Steuerelements bereitstellen müssen, damit Benutzer von Clienthilfsprogrammen das Steuerelement identifizieren können. Für die Listenansichtselemente ist die eigenschaft Name der Text des Listenelements. |
| get_accParent | Das übergeordnete des Listenansichtsobjekts ist ein Fenster ( ROLE_SYSTEM_WINDOW ), das das Steuerelement umgibt und denselben Name Eigenschaft und Fensterklassennamen wie das Steuerelement aufweist. Die Übergeordnete Eigenschaft der Listenansichtselemente ist das Listenansichtsobjekt. |
| get_accRole | Die Rolle von ROLE_SYSTEM_LIST, und jedes Element im Listenansicht-Steuerelement verfügt über die Role-Eigenschaft von ROLE_SYSTEM_LISTITEM. |
| get_accSelection | |
| get_accState | Die State-Eigenschaft des Listenansichtsobjekts ist eine Kombination aus einem oder mehreren der folgenden Werte: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN Die eigenschaft State der Listenansichtselemente ist eine Kombination aus einem oder mehreren der folgenden Werte: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_OFFSCREEN | STATE_SYSTEM_NORMAL Darüber hinaus weisen Kontrollkästchen-Listenansichtselemente auch den Status STATE_SYSTEM_CHECKEDauf. |
Notizen
- Microsoft Active Accessibility macht keinen Listenansichtselementtext in Anwendungen verfügbar, die eine Rückruffunktion verwenden, um den Text dem Element hinzuzufügen.
- Listenansichtselemente, die beschnitten werden, verfügen nicht über STATE_SYSTEM_INVISIBLE festgelegt. Um festzustellen, ob ein Listenelement abgeschnitten wird, können Clients die Koordinaten des Elements vergleichen, die von accLocation- mit dem Beschneidungsbereich des Fensters zurückgegeben werden.
- Microsoft Active Accessibility unterstützt die Verwendung der accNavigate-Methode nicht, um zum Kopfzeilensteuerelement in einem Listenansicht-Steuerelement zu navigieren, das sich in der Detailansicht befindet. Clients verwenden jedoch die AccessibleObjectFromPoint--Funktion, um zum Kopfzeilensteuerelement zu gelangen.
- Bei nicht rechteckigen Objekten wie Listenansichtselementen in der Detailansicht können die Koordinaten des umgebenden Rechtecks des Elements, das von acc Location abgerufen wird, fehlschlagen, wenn accHitTest getestet wird, da accHitTest die Grenzen des Objekts auf Pixelbasis bestimmt.