Controllo List-View (Informazioni di riferimento per gli elementi dell'interfaccia utente MSAA)
Nota
In questo argomento vengono descritti gli oggetti controllo List-View ai fini delle informazioni di riferimento sugli elementi dell'interfaccia utente MSAA. Come creare oggetti Controllo visualizzazione elenco 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 IAccessible seguenti:
| metodo | Commenti |
|---|---|
| accDoDefaultAction | L'oggetto visualizzazione elenco stesso non dispone di una proprietà DefaultAction , ma il metodo accDoDefaultAction fa doppio clic sugli elementi della visualizzazione elenco. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Proprietà IAccessible
Un controllo visualizzazione elenco supporta le proprietà IAccessible seguenti:
| 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 visualizzazione elenco stesso non supporta la proprietà Description . Tuttavia, la proprietà Description 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 dell'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à Name è il testo della voce di elenco. |
| get_accParent | L'elemento Parent dell'oggetto list-view è 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 degli elementi della visualizzazione elenco è l'oggetto visualizzazione elenco. |
| get_accRole | Il ruolo di ROLE_SYSTEM_LIST e ogni elemento nel controllo visualizzazione elenco ha la proprietà Role di ROLE_SYSTEM_LISTITEM. |
| get_accSelection | |
| get_accState | La proprietà State dell'oggetto visualizzazione elenco è una combinazione di uno o più dei valori seguenti: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_FOCUedizione Standard | D | STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_OFFSCRedizione Enterprise N | La proprietà State degli elementi della visualizzazione elenco è una combinazione di uno o più dei valori seguenti: | STATE_SYSTEM_INVISIBLE STATE_SYSTEM_FOCUedizione Standard D | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_edizione Standard LECTABLE | STATE_SYSTEM_edizione Standard LECTED STATE_SYSTEM_MULTI | edizione Standard LECTABLE | | STATE_SYSTEM_NORMAL STATE_SYSTEM_OFFSCRedizione Enterprise N | di STATE_SYSTEM_HOTTRACKED 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 funzione AccessibleObjectFromPoint per accedere al controllo intestazione.
- Per gli oggetti non rettangolari, ad esempio gli elementi della visualizzazione Dettagli, le coordinate del rettangolo di delimitazione dell'elemento recuperato da accLocation hanno esito negativo se testato con accHitTest perché accHitTest determina i limiti dell'oggetto in base a pixel per pixel.