La classe CListCtrl incapsula le funzionalità di un "controllo visualizzazione elenco," che visualizza un insieme di elementi ciascuno composto da un'icona (da un elenco di immagini) e un'etichetta. Oltre a un'icona e l'etichetta, ogni elemento può avere informazioni visualizzate in colonne a destra dell'icona e label. Questo controllo (e quindi la classe CListCtrl ) è disponibile solo per i programmi in esecuzione sotto Windows 95 e Windows NT versione 3.51 e versioni successive.
La seguente è una breve panoramica della classe CListCtrl . Per una discussione dettagliata, concettuale, vedere Utilizzando CListCtrl e Controllo argomenti nella guida del programmatore Visual C++.
Visualizzazioni
Controlli di visualizzazione elenco possono visualizzare il loro contenuto in quattro modi diversi, chiamati "viste".
Ogni elemento viene visualizzato come un'icona ingrandita (32 x 32 pixel) con un'etichetta di sotto di esso. L'utente può trascinare gli elementi in qualsiasi posizione nella finestra di visualizzazione elenco.
Ogni elemento viene visualizzato come una piccola icona (16 x 16 pixel) con l'etichetta per il diritto di esso. L'utente può trascinare gli elementi in qualsiasi posizione nella finestra di visualizzazione elenco.
Ogni elemento viene visualizzato come una piccola icona con un'etichetta per il diritto di esso. Gli elementi sono disposti in colonne e non possono essere trascinati in qualsiasi posizione nella finestra di visualizzazione elenco.
Ogni elemento appare sulla propria riga, con informazioni supplementari disposti in colonne a destra. La colonna più a sinistra contiene la piccola icona e l'etichetta e colonne successive contengono elementi secondari come specificato dall'applicazione. Un controllo header incorporato (classe CHeaderCtrl) implementa queste colonne. Per ulteriori informazioni sul controllo intestazione e colonne in una visualizzazione di report, vedere CListCtrl utilizzando: aggiunta di colonne al controllo (visualizzazione Report).
Lo stile di visualizzazione elenco corrente del controllo determina la visualizzazione corrente. Per ulteriori informazioni su questi questi stili e loro uso, vedere CListCtrl utilizzando: cambiando gli stili di controllo elenco.
Stili estesi
Gli stili elenco standard, oltre alla classe CListCtrl supporta un grande insieme di stili estesi, fornendo funzionalità arricchito. Alcuni esempi di questa funzionalità:
Se abilitato, consente la selezione automatica di un elemento quando il cursore rimane sull'elemento per un certo periodo di tempo.
Quando attivato, permette di controllare fino a voci DWORD . Ciò è possibile inserendo l'overhead di gestione dei dati dell'elemento sull'applicazione. Fatta eccezione per la selezione di elementi e informazioni di messa a fuoco, tutte le informazioni oggetto devono essere gestite dall'applicazione. Per ulteriori informazioni, vedere CListCtrl utilizzando: controlli elenco virtuale.
Se abilitato, consente il caldo tracking (automatico evidenziazione del testo articolo) e one– o two– clic attivazione dell'elemento evidenziato.
Se abilitato, consente il drag-and-drop riordinamento delle colonne in un controllo visualizzazione elenco. Disponibile solo nella visualizzazione report.
Per informazioni sull'utilizzo di questi nuovi esteso stili, vedere CListCtrl utilizzando: cambiando gli stili di controllo elenco.
Gli elementi e gli elementi secondari
Ogni elemento in un controllo visualizzazione elenco è costituito da un'icona (da un elenco di immagini), un'etichetta, uno stato corrente e un valore definito dall'applicazione (denominati "i dati dell'elemento"). Uno o più elementi secondari possono anche essere associati con ogni elemento. Un elemento "secondario" è una stringa che, nella visualizzazione dei report, può essere visualizzata in una colonna a destra dell'icona e l'etichetta di un elemento. Tutti gli elementi in un controllo visualizzazione elenco devono avere lo stesso numero di elementi secondari.
Classe CListCtrl fornisce diverse funzioni per l'inserimento, eliminazione, trovando e modificare questi elementi. Per ulteriori informazioni, vedere CListCtrl::GetItem, CListCtrl::InsertIteme CListCtrl::FindItem, CListCtrl utilizzando: aggiunta di elementi al controllo, e CListCtrl utilizzando: Scrolling, organizzando, l'ordinamento e ricerca in controlli elenco.
Per impostazione predefinita, il controllo visualizzazione elenco è responsabile per la memorizzazione di attributi icona e testo di un elemento. Tuttavia, oltre a questi tipi di elemento, la classe CListCtrl supporta "elementi richiamata". Un "elemento di richiamata" è un elemento di visualizzazione elenco per il quale l'applicazione — piuttosto che il controllo — memorizza il testo, icona o entrambi. Una maschera di callback viene utilizzata per specificare gli attributi che elemento (testo e/o sull'icona) sono forniti dall'applicazione. Se un'applicazione utilizza elementi richiamata, deve essere in grado di fornire gli attributi di testo e/o sull'icona on-demand. Elementi di richiamata sono utili quando l'applicazione già mantiene alcune di queste informazioni. Per ulteriori informazioni, vedere CListCtrl::GetCallBackMask e CListCtrl utilizzando: elementi di Callback e la maschera di Callback.
Elenchi immagini
Le icone, le immagini di elemento intestazione e application– definito stati per visualizzazione elenco elementi sono contenuti in diversi elenchi immagini (implementati dalla classe CImageList), che potrete creare e assegnare il controllo visualizzazione elenco. Ogni controllo di visualizzazione elenco può avere fino a quattro diversi tipi di elenchi immagini:
Utilizzata nella visualizzazione icona per grandezza icone.
Utilizzato nella piccola icona, elenco e rapporto visualizzazioni per versioni più piccole delle icone utilizzate nella visualizzazione icona.
Contiene immagini dello stato, che vengono visualizzate accanto all'icona di un elemento per indicare uno stato definito dall'applicazione.
Utilizzata nella visualizzazione report per piccole immagini che appaiono in ogni elemento del controllo intestazione.
Per impostazione predefinita, un controllo visualizzazione elenco distrugge gli elenchi di immagini assegnati ad essa quando esso viene distrutto; Tuttavia, lo sviluppatore può personalizzare tale comportamento distruggendo ogni elenco immagini quando non è più utilizzato, come determinato dall'applicazione. Per ulteriori informazioni, vedere CListCtrl utilizzando: gli elementi dell'elenco ed elenchi di immagini e CListCtrl utilizzando: gli elementi dell'elenco ed elenchi di immagine.
# include lt;afxcmn.h>
Membri della classe | Classe base | Gerarchia Chart
Campio&ninbsp; Esempio MFC DAOTABLE | Esempio MFC HTTPSVR | Esempio MFC LISTHDR | Esempio MFC ROWLIST | Esempio MFC DBVLIST
Vedere a&nchenbsp;CImageList