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.

IAccessible-Schnittstelle