Udostępnij za pośrednictwem


Kontrolka widoku drzewa (odwołanie do elementu interfejsu użytkownika MSAA)

Nuta

W tym temacie opisano kontrolki widoku drzewa obiektów na potrzeby odwołania do elementów interfejsu użytkownika MSAA. Sposób tworzenia kontrolki widoku drzewa obiektów w różnych strukturach interfejsu użytkownika nie jest opisany tutaj. Zapoznaj się z dokumentacją interfejsu API dotyczącą używanej platformy interfejsu użytkownika.

Kontrolka widoku drzewa wyświetla hierarchiczną listę elementów używających wierszy do łączenia powiązanych elementów w hierarchii. Każdy element składa się z etykiety i opcjonalnej mapy bitowej. Eksplorator Windows używa kontrolki widoku drzewa do wyświetlania katalogów.

Nazwa klasy okna dla kontrolki widoku drzewa jest WC_TREEVIEW, która jest zdefiniowana jako "SysTreeView" w commctrl.h.

Metody IAccessible

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

Metoda Komentarze
accDoDefaultAction Sam obiekt widoku drzewa nie ma metody accDoDefaultAction. W zależności od właściwości State elementu w widoku drzewa accDoDefaultAction rozwija lub zwija określony element.
accHitTest
accLocation
accNavigate
accSelect

Właściwości funkcji IAccessible

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

Własność Komentarze
get_accChild
get_accChildCount Właściwość ChildCount dla obiektu widoku drzewa to liczba elementów zawartych w widoku drzewa. Właściwość ChildCount dla każdego elementu widoku drzewa wynosi zero.
get_accDefaultAction Sam obiekt widoku drzewa nie ma właściwości DefaultAction. Element w widoku drzewa, który jest rozwinięty, ma wartość "Zwiń" jako właściwość DefaultAction, a element, który nie jest rozwinięty, ma wartość "Rozwiń" jako właściwość DefaultAction.
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut
get_accName Właściwość Name dla obiektu widoku drzewa jest uzyskiwana z tekstu okna kontrolki (lub podpisu). Ten tekst nie jest wyświetlany w kontrolce widoku drzewa, 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łaściwość Nazwa elementu w widoku drzewa to tekst wyświetlany w elemencie widoku drzewa.
get_accParent Właściwość Nadrzędna obiektu widoku drzewa to okno (ROLE_SYSTEM_WINDOW ), które otacza kontrolkę i ma taką samą właściwość Name i nazwę klasy okna jak kontrolka. Właściwość Nadrzędna każdego elementu w widoku drzewa jest obiektem widoku drzewa.
get_accRole Obiekt widoku drzewa ma właściwość roleROLE_SYSTEM_OUTLINE. Każdy element w widoku drzewa ma właściwość RolaROLE_SYSTEM_OUTLINEITEM.
get_accSelection
get_accState Właściwość State widoku drzewa jest kombinacją co najmniej jednej z następujących wartości : STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE
W przypadku elementów widoku drzewa właściwość State zawiera STATE_SYSTEM_EXPANDED lub STATE_SYSTEM_COLLAPSED.
Dodatkowe możliwe wartości właściwości stanu obejmują:
STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_HOTTRACKED
get_accValue Obiekt widoku drzewa nie ma wartości. Właściwość Value dla każdego elementu widoku drzewa jest poziomem wcięcia elementu w hierarchii. Na przykład w Eksploratorze Windows element "Desktop" ma właściwość Value "0"; element "Mój komputer", który znajduje się na następnym poziomie w hierarchii, ma właściwość Value "1"; a każdy z dysków, które znajdują się na następnym poziomie w hierarchii, mają właściwość Value "2".

Notatki

Właściwość accLocation elementów widoku drzewa zwraca tylko lokalizację tekstu w elemencie. Współrzędne zwracane przez accLocation dla elementów widoku drzewa nie zawierają ikony znajdującej się po lewej stronie tekstu.

interfejs IAccessible