List-View-Steuerelement (MSAA-UI-Elementreferenz)

  • Artikel

Hinweis

In diesem Thema werden List-View-Control-Objekte für Zwecke der MSAA-Benutzeroberflächenelementreferenz beschrieben. Das Erstellen von List-View Control-Objekten in verschiedenen Ui-Frameworks ist hier nicht beschrieben. Weitere Informationen finden Sie in der API-Referenzdokumentation für das von Ihnen verwendete Benutzeroberflächenframework.

Ein Listenansichtssteuerelement zeigt eine Auflistung von Elementen an, die jeweils aus einem Symbol und einer Bezeichnung bestehen, und bietet verschiedene 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 Explorer verwendet ein Listenansichtssteuerelement zum Anzeigen von Dateien.

Der Fensterklassenname für ein Listenansichtssteuerelement ist WC_LISTVIEW, das in Commctrl.h als "SysListView" definiert ist.

IAccessible-Methoden

Ein Listenansichtssteuerelement unterstützt die folgenden IAccessible-Methoden :

Methode Kommentare
accDoDefaultAction Das Listenansicht-Objekt selbst verfügt nicht über eine DefaultAction-Eigenschaft . die accDoDefaultAction-Methode doppelt klickt 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 Listenansicht-Objekt 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 Listenansichtssteuerelement jedoch ein Amper- 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 des Steuerelements (oder Untertitel) 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 Clientprogrammen das Steuerelement identifizieren können. Für die Listenansichtselemente ist die Name-Eigenschaft der Text des Listenelements.
get_accParent Das Übergeordnete Element des Listenansichtobjekts ist ein Fenster (ROLE_SYSTEM_WINDOW), das das Steuerelement umgibt und denselben Name-Eigenschafts- und Fensterklassennamen wie das Steuerelement aufweist. Die Parent-Eigenschaft der Listenansichtselemente ist das Listenansicht-Objekt.
get_accRole Die RolleROLE_SYSTEM_LIST, und jedes Element im Listenansichtssteuerelement verfügt über die Role-Eigenschaftvon ROLE_SYSTEM_LISTITEM.
get_accSelection
get_accState Die State-Eigenschaft des Listenansichtsobjekts 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 der Listenansichtselemente ist eine Kombination aus mindestens einem 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 Listenansichtselemente des Kontrollkästchens auch den Status STATE_SYSTEM_CHECKED auf.

Hinweise

  • Microsoft Active Accessibility macht keinen Listenansichtselementtext in Anwendungen verfügbar, die eine Rückruffunktion verwenden, um den Text dem Element hinzuzufügen.
  • Listenansichtselemente, die abgeschnitten sind, sind nicht STATE_SYSTEM_INVISIBLE festgelegt. Um zu bestimmen, ob ein Listenelement abgeschnitten ist, können Clients die von accLocation zurückgegebenen Koordinaten des Elements mit dem Abschneidebereich des Fensters vergleichen.
  • Microsoft Active Accessibility unterstützt nicht die Verwendung der accNavigate-Methode zum Navigieren zum Headersteuerelement in einem Listenansichtssteuerelement, das sich in der Detailansicht befindet. Clients verwenden jedoch die AccessibleObjectFromPoint-Funktion , um zum Headersteuerelement zu gelangen.
  • Bei nicht rechteckigen Objekten, z. B. 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 Begrenzungen des Objekts pixelweise bestimmt.

IAccessible-Schnittstelle