Condividi tramite


Controllo Visualizzazione albero (informazioni di riferimento sugli elementi dell'interfaccia utente MSAA)

Nota

In questo argomento vengono descritti gli oggetti Controllo visualizzazione albero ai fini del riferimento agli elementi dell'interfaccia utente MSAA. La procedura per creare oggetti Controllo visualizzazione albero in vari framework dell'interfaccia utente non è descritta qui. Vedere la documentazione di riferimento sulle API per il framework dell'interfaccia utente in uso.

Un controllo visualizzazione albero visualizza un elenco gerarchico di elementi utilizzando righe per connettere gli elementi correlati in una gerarchia. Ogni elemento è costituito da un'etichetta e da una bitmap facoltativa. Esplora risorse usa un controllo visualizzazione albero per visualizzare le directory.

Il nome della classe finestra per un controllo visualizzazione albero è WC_TREEVIEW, definito come "SysTreeView" in Commctrl.h.

Metodi IAccessible

Un controllo visualizzazione albero supporta i metodi IAccessible seguenti:

Metodo Commenti
accDoDefaultAction L'oggetto visualizzazione albero stesso non dispone di un metodo accDoDefaultAction . A seconda della proprietà State di un elemento nella visualizzazione albero, accDoDefaultAction espande o comprime l'elemento specificato.
accHitTest
accLocation
accNavigate
accSelect

Proprietà IAccessible

Un controllo visualizzazione albero supporta le proprietà IAccessible seguenti:

Proprietà Commenti
get_accChild
get_accChildCount La proprietà ChildCount per l'oggetto visualizzazione albero è il numero di elementi contenuti nella visualizzazione albero. La proprietà ChildCount per ogni elemento della visualizzazione albero è zero.
get_accDefaultAction L'oggetto visualizzazione albero stesso non dispone di una proprietà DefaultAction . Un elemento nella visualizzazione albero espanso ha "Collapse" come proprietà DefaultAction e un elemento non espanso ha "Expand" come proprietà DefaultAction .
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut
get_accName La proprietà Name per l'oggetto visualizzazione albero viene ottenuta dal testo della finestra del controllo (o didascalia). Questo testo non viene visualizzato con il controllo visualizzazione albero, pertanto gli sviluppatori del server devono fornire testo significativo nell'istruzione di definizione della risorsa del controllo per consentire agli utenti di utilità client di identificare il controllo. La proprietà Name per un elemento nella visualizzazione albero è il testo visualizzato nell'elemento della visualizzazione albero.
get_accParent La proprietà Parent dell'oggetto visualizzazione struttura ad albero è una finestra ( ROLE_SYSTEM_WINDOW ) che circonda il controllo e ha lo stesso nome della proprietà Name e della classe finestra del controllo. La proprietà Parent di ogni elemento nella visualizzazione albero è l'oggetto visualizzazione albero.
get_accRole L'oggetto visualizzazione albero ha la proprietà RoleROLE_SYSTEM_OUTLINE. Ogni elemento nella visualizzazione albero ha la proprietà RoleROLE_SYSTEM_OUTLINEITEM.
get_accSelection
get_accState La proprietà State per la visualizzazione struttura ad albero è una combinazione di uno o più dei valori seguenti: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE |
Per gli elementi della visualizzazione struttura ad albero, la proprietà State include STATE_SYSTEM_EXPANDED o STATE_SYSTEM_COLLAPSED.
I valori aggiuntivi possibili per la proprietà State includono:
| STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED STATE_SYSTEM_HOTTRACKED
get_accValue L'oggetto visualizzazione albero non ha un valore. La proprietà Value per ogni elemento della visualizzazione albero è il livello di rientro dell'elemento nella gerarchia. Ad esempio, in Esplora risorse, l'elemento "Desktop" ha una proprietà Value di "0"; l'elemento "My Computer", che si trova al livello successivo della gerarchia, ha una proprietà Value di "1"; e ognuna delle unità disco, che si trovano al livello successivo nella gerarchia, hanno una proprietà Value di "2".

Note

La proprietà accLocation degli elementi della visualizzazione albero restituisce la posizione solo del testo nell'elemento. Le coordinate restituite da accLocation per gli elementi della visualizzazione albero non includono l'icona che si trova a sinistra del testo.

Interfaccia IAccessible