List-View-Steuerelement (MSAA UI-Elementreferenz)
Hinweis
In diesem Thema werden List-View Control-Objekte für die MSAA UI-Elementreferenz beschrieben. Das Erstellen von List-View-Steuerelementobjekten in verschiedenen Benutzeroberflächenframeworks wird hier nicht beschrieben. Informationen zum verwendeten BENUTZERoberflächenframework finden Sie in der API-Referenzdokumentation.
Ein Listenansichtssteuerelement zeigt eine Auflistung von Elementen an, die jeweils aus einem Symbol und einer Bezeichnung bestehen, und bietet mehrere Möglichkeiten zum Anzeigen und Anordnen der Elemente. Beispielsweise werden zusätzliche Informationen zu jedem Element in Spalten rechts neben dem Symbol und der Bezeichnung angezeigt. Windows Der Explorer verwendet ein Listenansichtssteuerelement, um Dateien anzuzeigen.
Der Fensterklassenname für ein Listenansichtssteuerelement 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:
| Eigenschaft | Kommentare |
|---|---|
| get _ accChild | |
| get _ accChildCount | Die ChildCount-Eigenschaft 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 "Doppelklicken". |
| get _ accDescription | Das Listenansichtsobjekt selbst unterstützt die Description-Eigenschaft nicht. Die Description-Eigenschaft für jedes Listenansichtselement ist jedoch der Text, der in der zweiten und nachfolgenden Spalte 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 Listenansichtssteuerelement jedoch ein ampersand-Zeichen (&) enthält, gibt Microsoft Active Accessibility eine Zeichenfolge ungleich 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 in der Ressourcendefinitions-Anweisung des Steuerelements aussagekräftigen Text bereitstellen müssen, damit Benutzer von Clienthilfsprogrammen das Steuerelement identifizieren können. Für die Listenansichtselemente ist die Name-Eigenschaft der Text des Listenelements. |
| get _ accParent | Das übergeordnete Element des Listenansichtsobjekts ist ein Fenster ( ROLE SYSTEM _ _ WINDOW ), das das Steuerelement umschließt und über die gleiche Name-Eigenschaft und den gleichen Fensterklassennamen wie das Steuerelement verfügt. Die Parent-Eigenschaft der Listenansichtselemente ist das Listenansichtsobjekt. |
| get _ accRole | Die Rolle von ROLE SYSTEM _ _ LISTund jedes Element im Listenansichtssteuerelement 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 State-Eigenschaft der Listenansichtselemente ist eine Kombination aus einem oder mehreren der folgenden Werte: STATE _ _SYSTEM-UNSICHTBARER | ZUSTAND _ _ SYSTEMFOKUSSIERTES | _ ZUSTANDSSYSTEM _ FOKUSSIERBARES | _ ZUSTANDSSYSTEM _ AUSWÄHLBARES | _ ZUSTANDSSYSTEM _ AUSGEWÄHLTES | _ ZUSTANDSSYSTEM _ MEHRFACHAUSWÄHLBARES | _ ZUSTANDSSYSTEM _ HOTTRACKED | STATE SYSTEM _ _ OFFSCREEN | STATE SYSTEM _ _ NORMAL Darüber hinaus weisen Listenansichtselemente des Kontrollkästchens auch den Status STATE _ SYSTEM _ CHECKED auf. |
Notizen
- Microsoft Active Accessibility macht keinen Listenansichtselementtext in Anwendungen verfügbar, die eine Rückruffunktion verwenden, um den Text dem Element hinzuzufügen.
- Für abgeschnittene Listenansichtselemente ist STATE _ SYSTEM _ INVISIBLE nicht festgelegt. Um zu bestimmen, ob ein Listenelement abgeschnitten wird, können Clients die von accLocation zurückgegebenen Koordinaten des Elements mit dem Clippingbereich des Fensters vergleichen.
- Microsoft Active Accessibility unterstützt nicht die Verwendung der accNavigate-Methode, um zum Headersteuerelement in einem Listenansicht-Steuerelement zu navigieren, das sich in der Detailansicht befindet. Clients verwenden jedoch die AccessibleObjectFromPoint-Funktion, um zum Headersteuerelement zu gelangen.
- Bei nicht rechteckigen Objekten wie Listenansichtselementen in der Detailansicht schlagen die Koordinaten des von accLocation abgerufenen umgebenden Rechtecks des Elements fehl, wenn sie mit accHitTest getestet werden, da accHitTest die Grenzen des Objekts pixelweise bestimmt.