Udostępnij za pośrednictwem

List-View, kontrolka (odwołanie do elementu interfejsu użytkownika MSAA)

  • Artykuł

Nuta

W tym temacie opisano obiekty List-View Control na potrzeby odwołania do elementów interfejsu użytkownika MSAA. Sposób tworzenia obiektów kontroliList-View w różnych strukturach interfejsu użytkownika nie został opisany tutaj. Zapoznaj się z dokumentacją interfejsu API dotyczącą używanej platformy interfejsu użytkownika.

Kontrolka widoku listy wyświetla kolekcję elementów, z których każda składa się z ikony i etykiety, oraz udostępnia kilka sposobów wyświetlania i rozmieszczania elementów. Na przykład dodatkowe informacje o każdym elemencie są wyświetlane w kolumnach po prawej stronie ikony i etykiety. Eksplorator Windows używa kontrolki widoku listy do wyświetlania plików.

Nazwa klasy okna dla kontrolki widoku listy jest WC_LISTVIEW, która jest zdefiniowana jako "SysListView" w commctrl.h.

Metody IAccessible

Kontrolka widoku listy obsługuje następujące metody IAccessible:

Metoda Komentarze
accDoDefaultAction Sam obiekt widoku listy nie ma właściwości DefaultAction; jednak metoda accDoDefaultAction dwukrotnie klika elementy widoku listy.
accHitTest
accLocation
accNavigate
accSelect

Właściwości funkcji IAccessible

Kontrolka widoku listy obsługuje następujące właściwości IAccessible:

Własność Komentarze
get_accChild
get_accChildCount Właściwość ChildCount to liczba elementów na liście.
get_accDefaultAction Sam obiekt widoku listy nie ma właściwości DefaultAction; jednak właściwość DefaultAction dla każdego elementu widoku listy to "Dwukrotne kliknięcie".
get_accDescription Sam obiekt widoku listy nie obsługuje właściwości Description; jednak właściwość Description dla każdego elementu widoku listy to tekst zawarty w drugiej i kolejnej kolumnie elementu. Przecinek jest wstawiany między tekstem dla każdej kolumny.
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut Obiekty widoków listy nie mają skrótów klawiaturowych. Jeśli jednak tekst okna kontrolki widok-listy zawiera znak ampersand (&), funkcja Microsoft Active Accessibility zwraca ciąg inny niż null jako właściwość KeyboardShortcut.
get_accName Nazwa dla obiektu widoku listy jest uzyskiwany z tekstu okna kontrolki (lub podpisu). Ten tekst nie jest wyświetlany w kontrolce widoku listy, dlatego deweloperzy serwerów muszą podać zrozumiały tekst w instrukcji definicji zasobów kontrolki, aby ułatwić użytkownikom narzędzi klienckich identyfikację kontrolki. W przypadku elementów widoku listy właściwość Nazwa jest tekstem elementu listy.
get_accParent nadrzędny obiektu widoku listy jest oknem (ROLE_SYSTEM_WINDOW ), które otacza kontrolkę i ma taką samą właściwość Name i nazwę klasy okna co kontrolka. Właściwość Nadrzędna elementów widoku listy jest obiektem widoku listy.
get_accRole rolaROLE_SYSTEM_LIST, a każdy element w kontrolce widoku listy ma właściwość RolaROLE_SYSTEM_LISTITEM.
get_accSelection
get_accState Właściwość State obiektu widoku listy jest kombinacją co najmniej jednej z następujących wartości : STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN
Właściwość State elementów widoku listy jest kombinacją co najmniej jednej z następujących wartości:
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
Ponadto elementy widoku listy pól wyboru również mają stan STATE_SYSTEM_CHECKED.

Notatki

  • Ułatwienia dostępu Microsoft Active nie uwidacznia tekstu elementu widoku listy w aplikacjach, które używają funkcji wywołania zwrotnego w celu dodania tekstu do elementu.
  • Elementy widoku listy, które są obcięte, nie mają zestawu STATE_SYSTEM_INVISIBLE. Aby określić, czy element listy jest przycięty, klienci mogą porównać współrzędne elementu zwrócone przez accLocation z obszarem wycinki okna.
  • Usługa Microsoft Active Accessibility nie obsługuje używania metody accNavigate, aby przejść do kontrolki nagłówka w kontrolce widoku listy, która znajduje się w widoku Szczegółów. Jednak klienci używają funkcji AccessibleObjectFromPoint, aby przejść do kontrolki nagłówka.
  • W przypadku obiektów innych niż prostokątne, takich jak elementy widoku listy w widoku Szczegóły, współrzędne prostokąta ograniczenia elementu pobranego przez accLocation kończą się niepowodzeniem, jeśli testowano z accHitTest, ponieważ accHitTest określa granice obiektu na podstawie pikseli po pikselach.

interfejs IAccessible