Classe di CListCtrl

Articolo
03/05/2013

Incapsula la funzionalità "di un controllo visualizzazione elenco," che visualizza una raccolta di elementi ognuna costituito da un'icona (da un elenco immagini) e di un'etichetta.

class CListCtrl : public CWnd

Membri

Costruttori pubblici

Nome	Descrizione
CListCtrl::CListCtrl	Costruisce un oggetto CListCtrl.

Metodi pubblici

Nome	Descrizione
CListCtrl::ApproximateViewRect	Determina la larghezza e l'altezza richieste per visualizzare gli elementi di un controllo visualizzazione elenco.
CListCtrl::Arrange	Allineare gli elementi in una griglia.
CListCtrl::CancelEditLabel	Annulla l'operazione di modifica del testo elemento.
CListCtrl::Create	Crea un controllo elenco e lo collega a un oggetto CListCtrl.
CListCtrl::CreateDragImage	Crea un elenco di immagine di trascinamento di un elemento specificato.
CListCtrl::CreateEx	Crea un controllo elenco con gli stili estesi Windows specificati e lo collega a un oggetto CListCtrl.
CListCtrl::DeleteAllItems	Rimuove tutti gli elementi dal controllo.
CListCtrl::DeleteColumn	Elimina una colonna del controllo visualizzazione elenco.
CListCtrl::DeleteItem	Rimuove un elemento dal controllo.
CListCtrl::DrawItem	Chiamato quando un aspetto visivo di controllo del disegno personalizzato.
CListCtrl::EditLabel	Modifica sul posto di iniziare il testo di un elemento.
CListCtrl::EnableGroupView	Abilita o disabilita se gli elementi in una visualizzazione del controllo visualizzazione elenco come gruppo.
CListCtrl::EnsureVisible	Verifica che un elemento visibile.
CListCtrl::FindItem	Cerca una voce della visualizzazione elenco che specifica le caratteristiche.
CListCtrl::GetBkColor	Recupera il colore di sfondo di un controllo visualizzazione elenco.
CListCtrl::GetBkImage	Recupera l'immagine di sfondo corrente di un controllo visualizzazione elenco.
CListCtrl::GetCallbackMask	Recupera la maschera di callback per un controllo visualizzazione elenco.
CListCtrl::GetCheck	Recupera lo stato di visualizzazione corrente dell'immagine di stato associato a un elemento.
CListCtrl::GetColumn	Recupera gli attributi di una colonna del controllo.
CListCtrl::GetColumnOrderArray	Recupera l'ordine delle colonne (da sinistra a destra) di un controllo visualizzazione elenco.
CListCtrl::GetColumnWidth	Recupera la larghezza di una colonna nella visualizzazione rapporti o la visualizzazione elenco.
CListCtrl::GetCountPerPage	Calcola il numero di elementi adattabili verticalmente in un controllo visualizzazione elenco.
CListCtrl::GetEditControl	Recupera l'handle del controllo di modifica utilizzato per modificare il testo di un elemento.
CListCtrl::GetEmptyText	Recuperare la stringa da visualizzare se il controllo elenco corrente è vuoto.
CListCtrl::GetExtendedStyle	Recupera gli stili estesi correnti di un controllo visualizzazione elenco.
CListCtrl::GetFirstSelectedItemPosition	Recupera la posizione della prima voce della visualizzazione elenco selezionata in un controllo visualizzazione elenco.
CListCtrl::GetFocusedGroup	Recupera il gruppo con lo stato attivo nel controllo elenco corrente.
CListCtrl::GetGroupCount	Recupera il numero dei gruppi nel controllo elenco corrente.
CListCtrl::GetGroupInfo	Ottiene le informazioni relative a un gruppo specifico del controllo visualizzazione elenco.
CListCtrl::GetGroupInfoByIndex	Recupera informazioni su un gruppo specificato nel controllo elenco corrente.
CListCtrl::GetGroupMetrics	Recupera la metrica di un gruppo.
CListCtrl::GetGroupRect	Recupera il rettangolo di delimitazione di un gruppo specificato nel controllo elenco corrente.
CListCtrl::GetGroupState	Recupera lo stato di un gruppo specificato nel controllo elenco corrente.
CListCtrl::GetHeaderCtrl	Recupera il controllo intestazione di un controllo visualizzazione elenco.
CListCtrl::GetHotCursor	Recupera il cursore utilizzato quando il hot track è abilitato per un controllo visualizzazione elenco.
CListCtrl::GetHotItem	Recupera attualmente la voce della visualizzazione elenco sotto il cursore.
CListCtrl::GetHoverTime	Recupera il punto corrente di permanenza di un controllo visualizzazione elenco.
CListCtrl::GetImageList	Recupera l'handle di un elenco immagini utilizzato per disegnare le voci della visualizzazione elenco.
CListCtrl::GetInsertMark	Recupera la posizione corrente del segno di inserimento.
CListCtrl::GetInsertMarkColor	Recupera il colore corrente del segno di inserimento.
CListCtrl::GetInsertMarkRect	Recupera il rettangolo che limita il punto di inserimento.
CListCtrl::GetItem	Recupera gli attributi di una voce della visualizzazione elenco.
CListCtrl::GetItemCount	Recupera il numero di elementi in un controllo visualizzazione elenco.
CListCtrl::GetItemData	Recupera il valore specifico dell'applicazione associato a un elemento.
CListCtrl::GetItemIndexRect	Recupera il rettangolo di delimitazione di tutto o parte di un elemento secondario nel controllo elenco corrente.
CListCtrl::GetItemPosition	Recupera il percorso di una voce della visualizzazione elenco.
CListCtrl::GetItemRect	Recupera il rettangolo di delimitazione di un elemento.
CListCtrl::GetItemSpacing	Calcola la spaziatura tra gli elementi nel controllo elenco corrente.
CListCtrl::GetItemState	Recupera lo stato di una voce della visualizzazione elenco.
CListCtrl::GetItemText	Recupera il testo di una voce della visualizzazione elenco o di un elemento secondario.
CListCtrl::GetNextItem	Cerca una voce della visualizzazione elenco con le proprietà specificate e con la relazione specificata a un elemento specificato.
CListCtrl::GetNextItemIndex	Recupera l'indice dell'elemento nel controllo elenco corrente con un set specificato di proprietà.
CListCtrl::GetNextSelectedItem	Recupera l'indice di una posizione della voce della visualizzazione elenco e la posizione della voce della visualizzazione elenco selezionare seguente per l'iterazione.
CListCtrl::GetNumberOfWorkAreas	Recupera il numero corrente delle aree di lavoro per un controllo visualizzazione elenco.
CListCtrl::GetOrigin	Recupera l'origine di visualizzazione corrente per un controllo visualizzazione elenco.
CListCtrl::GetOutlineColor	Recupera il colore del bordo di un controllo visualizzazione elenco.
CListCtrl::GetSelectedColumn	Recupera l'indice della colonna selezionata nel controllo elenco.
CListCtrl::GetSelectedCount	Recupera il numero di elementi selezionati nel controllo elenco.
CListCtrl::GetSelectionMark	Recupera il contrassegno di selezione di un controllo visualizzazione elenco.
CListCtrl::GetStringWidth	Determina la larghezza della colonna minima necessaria per visualizzare qualsiasi stringa specificata.
CListCtrl::GetSubItemRect	Recupera il rettangolo di delimitazione di un elemento in un controllo visualizzazione elenco.
CListCtrl::GetTextBkColor	Recupera il colore di sfondo del testo di un controllo visualizzazione elenco.
CListCtrl::GetTextColor	Recupera il colore del testo di un controllo visualizzazione elenco.
CListCtrl::GetTileInfo	Recupera informazioni su una sezione in un controllo visualizzazione elenco.
CListCtrl::GetTileViewInfo	Recupera le informazioni su un controllo visualizzazione elenco nella visualizzazione affiancata.
CListCtrl::GetToolTips	Recupera il controllo di descrizione comandi che il controllo elenco appariranno le descrizioni comandi.
CListCtrl::GetTopIndex	Recupera l'indice dell'elemento visibile in primo piano.
CListCtrl::GetView	Ottiene la visualizzazione del controllo visualizzazione elenco.
CListCtrl::GetViewRect	Recupera il rettangolo di delimitazione di tutti gli elementi nel controllo elenco.
CListCtrl::GetWorkAreas	Recupera le aree di lavoro correnti di un controllo visualizzazione elenco.
CListCtrl::HasGroup	Determina se il controllo elenco ha il gruppo specificato.
CListCtrl::HitTest	Determina la voce della visualizzazione elenco è in un percorso specificato.
CListCtrl::InsertColumn	Inserisce una nuova colonna in un controllo visualizzazione elenco.
CListCtrl::InsertGroup	Inserisce un gruppo nel controllo elenco.
CListCtrl::InsertGroupSorted	Inserisce il gruppo specificato in un elenco ordinato dei gruppi.
CListCtrl::InsertItem	Inserisce un nuovo elemento in un controllo visualizzazione elenco.
CListCtrl::InsertMarkHitTest	Recupera il punto di inserimento più vicino a un punto specificato.
CListCtrl::IsGroupViewEnabled	Determina se il punto di vista del gruppo è abilitato per un controllo visualizzazione elenco.
CListCtrl::IsItemVisible	Indica se un elemento specificato nel controllo elenco corrente è visibile.
CListCtrl::MapIDToIndex	Esegue il mapping dell'ID univoco di un elemento nel controllo elenco corrente a un indice.
CListCtrl::MapIndexToID	Esegue il mapping dell'indice di un elemento nel controllo elenco corrente a un ID univoco
CListCtrl::MoveGroup	Sposta il gruppo specificato.
CListCtrl::MoveItemToGroup	Sposta il gruppo specificato negli indice in base zero specificato del controllo visualizzazione elenco.
CListCtrl::RedrawItems	Impone un controllo visualizzazione elenco per aggiornare un intervallo di elementi.
CListCtrl::RemoveAllGroups	Rimuove tutti i gruppi da un controllo visualizzazione elenco.
CListCtrl::RemoveGroup	Rimuove il gruppo specificato dal controllo visualizzazione elenco.
CListCtrl::Scroll	Scorre il contenuto di un controllo visualizzazione elenco.
CListCtrl::SetBkColor	Imposta il colore di sfondo del controllo visualizzazione elenco.
CListCtrl::SetBkImage	L'immagine di sfondo corrente di un controllo visualizzazione elenco.
CListCtrl::SetCallbackMask	Imposta la maschera di callback per un controllo visualizzazione elenco.
CListCtrl::SetCheck	Imposta lo stato di visualizzazione corrente dell'immagine di stato associato a un elemento.
CListCtrl::SetColumn	Imposta gli attributi di una colonna di visualizzazione elenco.
CListCtrl::SetColumnOrderArray	Imposta l'ordine delle colonne (da sinistra a destra) di un controllo visualizzazione elenco.
CListCtrl::SetColumnWidth	Modificare la larghezza di una colonna nella visualizzazione rapporti o la visualizzazione elenco.
CListCtrl::SetExtendedStyle	Imposta stili estesi correnti di un controllo visualizzazione elenco.
CListCtrl::SetGroupInfo	Imposta le informazioni per il gruppo specificato di controllo visualizzazione elenco.
CListCtrl::SetGroupMetrics	Imposta la metrica del gruppo di un controllo visualizzazione elenco.
CListCtrl::SetHotCursor	Imposta il cursore utilizzato quando il hot track è abilitato per un controllo visualizzazione elenco.
CListCtrl::SetHotItem	Imposta l'elemento personalizzazione corrente di un controllo visualizzazione elenco.
CListCtrl::SetHoverTime	Imposta l'ora corrente del passaggio del mouse di un controllo visualizzazione elenco.
CListCtrl::SetIconSpacing	Imposta la spaziatura tra le icone in un controllo visualizzazione elenco.
CListCtrl::SetImageList	Assegna un elenco immagini a un controllo visualizzazione elenco.
CListCtrl::SetInfoTip	Imposta il testo di descrizione comando.
CListCtrl::SetInsertMark	Impostare il punto di inserimento nella posizione definita.
CListCtrl::SetInsertMarkColor	Imposta il colore del punto di inserimento.
CListCtrl::SetItem	Imposta alcuni o tutti gli attributi di una voce della visualizzazione elenco.
CListCtrl::SetItemCount	Rende un controllo visualizzazione elenco per l'aggiunta di un numero elevato di elementi.
CListCtrl::SetItemCountEx	Imposta il conteggio di elementi per un controllo visualizzazione elenco virtuale.
CListCtrl::SetItemData	Imposta l'indice specifico dell'elemento.
CListCtrl::SetItemIndexState	Imposta lo stato di un elemento nel controllo elenco corrente.
CListCtrl::SetItemPosition	Sposta un elemento in una posizione specificata in un controllo visualizzazione elenco.
CListCtrl::SetItemState	Modifica lo stato di un elemento in un controllo visualizzazione elenco.
CListCtrl::SetItemText	Modifica il testo di una voce della visualizzazione elenco o di un elemento secondario.
CListCtrl::SetOutlineColor	Imposta il colore del bordo di un controllo visualizzazione elenco.
CListCtrl::SetSelectedColumn	Imposta la colonna selezionata del controllo visualizzazione elenco.
CListCtrl::SetSelectionMark	Imposta il flag di selezione di un controllo visualizzazione elenco.
CListCtrl::SetTextBkColor	Imposta il colore di sfondo del testo in un controllo visualizzazione elenco.
CListCtrl::SetTextColor	Imposta il colore del testo di un controllo visualizzazione elenco.
CListCtrl::SetTileInfo	Imposta le informazioni per una sezione del controllo visualizzazione elenco.
CListCtrl::SetTileViewInfo	Imposta le informazioni che un controllo visualizzazione elenco utilizza la visualizzazione affiancata.
CListCtrl::SetToolTips	Imposta il controllo di descrizione comandi che il controllo elenco verrà utilizzata per visualizzare le descrizioni comandi.
CListCtrl::SetView	Imposta la visualizzazione del controllo visualizzazione elenco.
CListCtrl::SetWorkAreas	Imposta l'area in cui le icone possono essere visualizzati in un controllo visualizzazione elenco.
CListCtrl::SortGroups	Ordina i gruppi di controllo visualizzazione elenco con una funzione definita dall'utente.
CListCtrl::SortItems	Ordina le voci della visualizzazione elenco utilizzando una funzione di confronto definita dall'applicazione.
CListCtrl::SortItemsEx	Ordina le voci della visualizzazione elenco utilizzando una funzione di confronto definita dall'applicazione.
CListCtrl::SubItemHitTest	Determina la voce della visualizzazione elenco, se presente, è in un percorso specificato.
CListCtrl::Update	Forza il controllo per aggiornare un elemento specificato.

Note

Oltre a un'icona e a un'etichetta, ogni elemento può contenere informazioni visualizzate nelle colonne a destra dell'icona e dell'etichetta.Questo controllo e la classe CListCtrl ) è disponibile solo per i programmi in esecuzione in versioni 3,51 di Windows NT e Windows 95/98 e successive.

Ecco una breve panoramica della classe CListCtrl.Per una descrizione dettagliata e concettuale, vedere Utilizzando CListCtrl e Controlli.

Visualizzazioni

I controlli di visualizzazione elenchi possono visualizzare il contenuto in quattro modi diversi, denominati "visualizzazioni."

Visualizzazione icone

Ogni elemento viene visualizzato come pixel dell'icona grande utilizzata (32 x 32) con un'etichetta in.L'utente può trascinare gli elementi in un punto qualsiasi della finestra di visualizzazione elenco.
Piccola visualizzazione icone

Ogni elemento viene visualizzato come piccoli pixel dell'icona (16 x 16) con l'etichetta a destra di.L'utente può trascinare gli elementi in un punto qualsiasi della finestra di visualizzazione elenco.
Visualizzazione elenco

Ogni elemento viene visualizzato come piccola icona con un'etichetta a destra di.Gli elementi sono disposti in colonne e non possono essere trascinate direttamente in una posizione nella finestra visualizzazione elenco.
Visualizzazione di rapporti

Ogni elemento viene visualizzato su una riga distinta, con informazioni aggiuntive disposti in colonne a destra.La colonna più a sinistra contiene una piccola icona e etichetta e colonne successive contengono elementi secondari come specificato dall'applicazione.Un controllo intestazione incorporato (classe) CHeaderCtrlimplementa tali colonne.Per ulteriori informazioni sul controllo intestazione e colonne in una visualizzazione del rapporto, vedere Utilizzando CListCtrl: Aggiunta di colonne al controllo (visualizzazione di rapporti).

Vedere anche:

Articolo della Knowledge Base Q250614: HOWTO: Elementi in un CListCtrl nella visualizzazione rapporti
Articolo della Knowledge Base Q200054: PRB: OnTimer () non viene chiamato ripetutamente per un controllo elenco

Lo stile di visualizzazione elenco corrente del controllo determina la visualizzazione corrente.Per ulteriori informazioni su questi stili e sul relativo utilizzo, vedere Utilizzando CListCtrl: Modificare gli stili del controllo elenco.

Extended Styles

Oltre agli stili standard di elenco, classificare CListCtrl supporta un insieme ampio di stili estesi, fornendo funzionalità arricchita.Alcuni esempi di questa funzionalità includono:

Selezione del passaggio del mouse

Una volta abilitata, consente la selezione automatica di un elemento quando il cursore rimane sull'elemento per un determinato punto.
Visualizzazioni elenco virtuali

Una volta abilitata, consente al controllo supporta fino a DWORD gli elementi.Ciò è possibile racchiudere il sovraccarico di gestione dei dati sull'applicazione.Fatta eccezione per la selezione dell'elemento e le informazioni di stato attivo, tutte le informazioni sull'elemento devono essere gestite dall'applicazione.Per ulteriori informazioni, vedere Utilizzando CListCtrl: Controlli elenco virtuali.
Per l'attivazione di un oggetto e due clic su

Una volta abilitata, consente il hot track (evidenziare automatica di testo elemento) e di attivazione di una o due clic sull'elemento evidenziato.
L'ordine delle colonne di trascinamento della selezione

Una volta abilitata, consente il riordinamento trascinamento della selezione colonne in un controllo visualizzazione elenco.Disponibile solo nella visualizzazione rapporti.

Per informazioni sull'utilizzo di questi nuovi stili estesi, vedere Utilizzando CListCtrl: Modificare gli stili del controllo elenco.

Gli elementi e secondari

Ogni elemento in un controllo elenco è costituito da un'icona (da un elenco immagini), etichetta, uno stato corrente e di un valore definito dall'applicazione (definito come "dati dell'elemento").Uno o più elementi secondari possono essere associati a ciascun elemento."Un elemento secondario" è una stringa che, nella visualizzazione di rapporti, può essere visualizzato in una colonna a destra dell'icona eetichetta di un elemento.Tutti gli elementi in un controllo elenco devono avere lo stesso numero di elementi secondari.

La classe CListCtrl fornisce numerose funzioni per l'inserimento, l'eliminazione, l'individuazione e la modifica di questi elementi.Per ulteriori informazioni, vedere CListCtrl::GetItem, CListCtrl::InsertIteme CListCtrl::FindItem, Utilizzando CListCtrl: Aggiunta di elementi al controlloe Utilizzando CListCtrl: Scorrendo, disporre, l'ordinamento e la ricerca in controlli elenco.

Per impostazione predefinita, il controllo elenco è responsabile dell'archiviazione dell'icona e gli attributi di testo di un elemento.Tuttavia, oltre a questi tipi di elemento, la classe CListCtrl "supporta gli elementi di callback." "Un elemento di callback" è una voce della visualizzazione elenco per cui l'applicazione — anziché il controllo archivia il testo, l'icona, o di entrambi.Una maschera di callback viene utilizzata per specificare gli attributi dell'elemento (testo) e/o icona vengono forniti dall'applicazione.Se un'applicazione utilizza elementi di callback, deve essere in grado di fornire attributi dell'icona e/o di testo su richiesta.Gli elementi di callback sono utili quando l'applicazione è già aggiornati alcune di queste informazioni.Per ulteriori informazioni, vedere Utilizzando CListCtrl: elementi di callback e la maschera di callback.

Elenchi di immagini

Icone, immagini voce di intestazione e stati definiti dall'applicazione per le voci della visualizzazione elenco sono contenuti in più elenchi di immagini (implementati dalla classe CImageList), che crea e assegnare al controllo elenco.Ogni controllo visualizzazione elenco può contenere fino a quattro tipi diversi di elenchi di immagini:

L'icona grande

Utilizzato nella visualizzazione icone per le icone grandi utilizzate.
Piccola icona

Utilizzato in piccoli icona, elencare e visualizzazioni dei rapporti per le versioni minori saranno le icone utilizzate in visualizzazione icone.
Stato definito dall'applicazione

Contiene le immagini di stato, che viene visualizzata accanto all'icona di un elemento per indicare uno stato definito dall'applicazione.
Voce di intestazione

Utilizzato nella visualizzazione report per piccole immagini visualizzate in ogni elemento del controllo intestazione.

Per impostazione predefinita, un controllo visualizzazione elenco elimina gli elenchi di immagini assegnati quando viene eliminato; tuttavia, lo sviluppatore può personalizzare questo comportamento eliminazione di ogni elenco immagini quando non viene più utilizzato, come determinato dall'applicazione.Per ulteriori informazioni, vedere Utilizzando CListCtrl: Elementi di elenco e elenchi di immagini.