controllo List-View (riferimento all'elemento dell'interfaccia utente MSAA)
Nota
In questo argomento vengono descritti List-View oggetti Control ai fini della guida di riferimento agli elementi dell'interfaccia utente MSAA. Come creare List-View oggetti control in vari framework dell'interfaccia utente non è descritto qui. Vedere la documentazione di riferimento sulle API per il framework dell'interfaccia utente in uso.
Un controllo visualizzazione elenco visualizza una raccolta di elementi, ognuno costituito da un'icona e da un'etichetta e offre diversi modi per visualizzare e disporre gli elementi. Ad esempio, le informazioni aggiuntive su ogni elemento vengono visualizzate nelle colonne a destra dell'icona e dell'etichetta. Esplora risorse usa un controllo visualizzazione elenco per visualizzare i file.
Il nome della classe della finestra per un controllo visualizzazione elenco è WC_LISTVIEW, definito come "SysListView" in Commctrl.h.
Metodi IAccessible
Un controllo visualizzazione elenco supporta i metodi diIAccessible seguenti:
| Metodo | Commenti |
|---|---|
| accDoDefaultAction | L'oggetto visualizzazione elenco stesso non dispone di una proprietà DefaultAction; Tuttavia, il metodoaccDoDefaultActionfa doppio clic sugli elementi della visualizzazione elenco. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Proprietà IAccessible
Un controllo visualizzazione elenco supporta le proprietàIAccessibleseguenti:
| Proprietà | Commenti |
|---|---|
| get_accChild | |
| get_accChildCount | La proprietà ChildCount è il numero di elementi nell'elenco. |
| get_accDefaultAction | L'oggetto visualizzazione elenco stesso non dispone di una proprietà DefaultAction; Tuttavia, la proprietà DefaultAction per ogni elemento della visualizzazione elenco è "Doppio clic". |
| get_accDescription | L'oggetto list-view stesso non supporta la proprietà Descrizione; Tuttavia, la proprietà Descrizione per ogni elemento della visualizzazione elenco è il testo contenuto nella seconda e nelle colonne successive dell'elemento. Viene inserita una virgola tra il testo per ogni colonna. |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | Gli oggetti list-views non dispongono di tasti di scelta rapida. Tuttavia, se il testo della finestra per il controllo visualizzazione elenco contiene un carattere e commerciale (&) , Microsoft Active Accessibility restituisce una stringa non Null come proprietà KeyboardShortcut. |
| get_accName | Il Nome per l'oggetto visualizzazione elenco viene ottenuto dal testo della finestra del controllo (o didascalia). Questo testo non viene visualizzato con il controllo visualizzazione elenco, pertanto gli sviluppatori del server devono fornire testo significativo nell'istruzione di definizione delle risorse del controllo per consentire agli utenti di utilità client di identificare il controllo. Per gli elementi della visualizzazione elenco, la proprietà nome è il testo dell'elemento di elenco. |
| get_accParent | L'padre dell'oggetto visualizzazione elenco è una finestra ( ROLE_SYSTEM_WINDOW ) che circonda il controllo e ha lo stesso nome proprietà e classe finestra come controllo. La proprietà padre degli elementi della visualizzazione elenco è l'oggetto visualizzazione elenco. |
| get_accRole | Il ruolo di di ROLE_SYSTEM_LISTe ogni elemento nel controllo visualizzazione elenco dispone della proprietà ruolo di ROLE_SYSTEM_LISTITEM. |
| get_accSelection | |
| get_accState | La proprietà state dell'oggetto visualizzazione elenco è una combinazione di uno o più dei valori di seguenti: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN La proprietà state degli elementi della visualizzazione elenco è una combinazione di uno o più dei valori seguenti: 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 Inoltre, anche gli elementi della visualizzazione elenco casella di controllo hanno lo stato STATE_SYSTEM_CHECKED. |
Note
- Microsoft Active Accessibility non espone il testo dell'elemento della visualizzazione elenco nelle applicazioni che usano una funzione di callback per aggiungere il testo all'elemento.
- Gli elementi della visualizzazione elenco ritagliati non hanno STATE_SYSTEM_INVISIBLE impostato. Per determinare se una voce di elenco viene ritagliata, i client possono confrontare le coordinate dell'elemento restituite da accLocation con l'area di ritaglio della finestra.
- Microsoft Active Accessibility non supporta l'uso del metodo accNavigate per passare al controllo intestazione all'interno di un controllo visualizzazione elenco presente nella visualizzazione Dettagli. Tuttavia, i client usano la funzioneAccessibleObjectFromPointper accedere al controllo intestazione.
- Per gli oggetti non rettangolari, ad esempio gli elementi della visualizzazione Dettagli, le coordinate del rettangolo di delimitazione dell'elemento recuperate da accLocation hanno esito negativo se testate con accHitTest perché accHitTest determina i limiti dell'oggetto in base a pixel per pixel.