Controllo ListView

Controllo ListView che visualizza una singola colonna di valori con un'icona accanto a ogni elemento. Consente all'utente di selezionare una singola stringa o un valore intero per una proprietà da un elenco predeterminato. I valori possibili vengono letti dalla tabella ListView. È possibile associare il controllo a un valore intero o stringa immettendo il nome della proprietà nella colonna Property della tabella Control.

Il contenuto del campo Testo della tabella Di controllo non viene mai visualizzato dal controllo ListView. Questo campo specifica invece lo stile del testo da visualizzare dal controllo e contiene una descrizione del controllo utilizzato dalle utilità di revisione dello schermo. Per impostare il tipo di carattere e lo stile del carattere di una stringa di testo, anteporre la stringa dei caratteri visualizzati con {\style} o {&style}. Dove style è un identificatore elencato nella colonna TextStyle della tabella TextStyle. Se nessuno di questi elementi è presente, ma la proprietà DefaultUIFont è definita come uno stile di testo valido, verrà utilizzato tale tipo di carattere. Le informazioni seguenti sono lette dalle utilità di revisione dello schermo come descrizione del controllo. Vedere Accessibilità.

Attributi di controllo

È possibile usare gli attributi seguenti con questo controllo. Per modificare il valore di un attributo usando un evento, sottoscrivere il controllo a un Oggetto ControlEvent nella tabella EventMapping ed elencare l'identificatore dell'attributo nella colonna Attribute. Immettere l'identificatore dell'evento ControlEvent nella colonna Evento.

Identificatore dell'attributo	Bit esadecimale	Descrizione
IndirectPropertyName		Si tratta del nome di una proprietà indiretta associata al controllo . Se il bit dell'attributo indiretto è impostato, il controllo visualizza o modifica il valore della proprietà con questo nome. Se il bit dell'attributo indiretto è impostato, questo nome corrisponde anche al valore della proprietà elencata nella colonna Proprietà della tabella Control.
Posizione		Posizione del controllo nella finestra di dialogo. Immettere la larghezza, l'altezza e le coordinate del controllo nell'angolo sinistro del controllo nelle colonne Width, Height, X e Y della tabella Control. Usare le unità di installazione per lunghezza e distanza.
PropertyName		Si tratta del nome della proprietà associata a questo controllo. Se il bit dell'attributo indiretto non è impostato, il controllo visualizza o modifica il valore della proprietà con questo nome. Questo attributo viene specificato nella colonna Property della tabella Control.
PropertyValue		Valore corrente della proprietà visualizzata o modificata da questo controllo. Se il bit dell'attributo indiretto non è impostato, questo è il valore di PropertyName. Se il bit dell'attributo indiretto è impostato, questo è il valore di IndirectPropertyName. Se l'attributo viene modificato, il controllo riflette il nuovo valore.
Text		Per visualizzare il testo nelle utilità per la lettura dello schermo, immettere il testo nella colonna Testo della tabella Control. Vedere Accessibilità.
Visible	0x00000000 0x00000001	Controllo nascosto. Controllo visibile. Includere questo bit nella parola bit della colonna Attributes della tabella Control per rendere visibile o nascosto il controllo al momento della creazione. È anche possibile nascondere o visualizzare un controllo tramite la tabella ControlCondition.
Abilitato	0x00000000 0x00000002	Controllo in uno stato disabilitato. Controllo in uno stato abilitato. Includere questo bit nella parola bit nella colonna Attributi del controllo per abilitare il controllo alla creazione. È anche possibile abilitare o disabilitare un controllo tramite la tabella ControlCondition.
Affondata	0x00000000 0x00000004	Visualizza lo stile di visualizzazione predefinito. Visualizza il controllo con un aspetto incassato, 3D. Includere questi bit nella parola bit nella colonna Attributi della tabella Control.
Indiretto	0x00000000 0x00000008	Il controllo visualizza o modifica il valore della proprietà nella colonna Proprietà della tabella Control. Il controllo visualizza o modifica il valore della proprietà con l'identificatore elencato nella colonna Proprietà della tabella Control. Determina se alla proprietà associata a questo controllo viene fatto riferimento indirettamente.
Integer	0x00000000 0x00000010	La proprietà associata al controllo è un valore stringa. La proprietà associata al controllo è un valore intero. Includere questo bit nella parola bit della colonna Attributes della tabella Control per impostare questo attributo alla creazione del controllo.
RTLRO	0x00000000 0x00000020	Il testo nel controllo viene visualizzato in ordine di lettura da sinistra a destra. Il testo nel controllo viene visualizzato in ordine di lettura da destra a sinistra.
RightAligned	0x00000000 0x00000040	Il testo nel controllo è allineato a sinistra. Il testo nel controllo è allineato a destra.
LeftScroll	0x00000000 0x00000080	La barra di scorrimento si trova sul lato destro del controllo. La barra di scorrimento si trova sul lato sinistro del controllo.
Bidi	0x000000E0	Impostare questo valore per una combinazione degli attributi RTLRO, RightAligned e LeftScroll .
Ordinati	0x00000000 0x00010000	Elementi visualizzati in ordine alfabetico. Elementi visualizzati nell'ordine specificato nella tabella ListView. Includere questo bit nella parola bit nella colonna Attributes per visualizzare gli elementi nell'ordine specificato dalla colonna Order della tabella ListView.
FixedSize	0x00000000 0x00100000	Estende l'immagine dell'icona per adattarsi al controllo. Ritaglia o centra l'immagine dell'icona nel controllo . Includere questo bit nella parola bit della colonna Attributes della tabella Control.
IconSize	0x00000000 0x00200000 0x00400000 0x00600000	Carica la prima immagine. Carica la prima immagine 16x16. Carica la prima immagine 32x32. Carica la prima immagine 48x48. Un file icona può contenere immagini di dimensioni diverse della stessa icona. Includere il valore della parola di bit appropriata nella colonna Attributi della tabella Control Se questi bit non sono impostati, il programma di installazione ignora l'attributo FixedSize e l'immagine viene estesa per adattarsi al rettangolo di controllo. Se vengono impostati sia i bit IconSize che i bit FixedSize, un'immagine più piccola del controllo è allineata al centro e un'immagine è più grande del controllo che viene ridotta per adattarsi.

 

Osservazioni:

Questo controllo può essere creato dalla classe WC_LISTVIEW usando la funzione CreateWindowEx. Ha gli stili di LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLEedizione Standard L, LVS_SHOWedizione Standard LALWAYS, WS_BORDER e WS_TABSTOP. Se il bit dello stile ordinato non è attivo, il controllo ha anche lo stile LVS_SORTASCENDING .

Per la compatibilità con le utilità per la lettura dello schermo, quando si crea una finestra di dialogo con un controllo ListView come primo controllo attivo, è necessario impostare il campo di testo appartenente al campo di modifica il primo controllo attivo nella tabella Dialog. Poiché il testo statico non può concentrarsi, quando il dialogo viene creato il campo di modifica avrà inizialmente lo stato attivo come previsto, ma in questo modo si garantisce che le utilità per la lettura dello schermo visualizzino le informazioni corrette.