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.
Tematy pokrewne
-
interfejs IAccessible