Esempio ROWLIST: selezione di intere righe nelle visualizzazioni elenco

Aggiornamento: novembre 2007

Nell'esempio ROWLIST viene illustrata la selezione di intere righe in una modalità report della classe di controlli comuni MFC CListView. Nell'esempio viene implementata una classe riutilizzabile, CListViewEx, che fornisce la selezione di intere righe come modalità di visualizzazione aggiuntiva di un controllo visualizzazione elenco. CListViewEx utilizza la modalità creata dal proprietario per eseguire tutte le operazioni di disegno per il controllo. È possibile utilizzare la classe nei progetti creati, direttamente o come classe base. In ROWLIST viene anche illustrato come utilizzare immagini sovrapposte e immagini di stato con un controllo visualizzazione elenco.

Nota sulla sicurezza:
Questo esempio di codice viene fornito solo a scopo dimostrativo e non deve essere utilizzato in applicazioni o siti Web, poiché potrebbe non implementare le tecniche migliori a livello di sicurezza. Microsoft esclude ogni responsabilità per danni diretti o indiretti derivanti dall'utilizzo dell'esempio di codice per scopi diversi da quelli previsti.

Per ottenere gli esempi e le istruzioni per l'installazione:

• In Visual Studio scegliere Esempi dal menu ?.

  Per ulteriori informazioni, vedere Individuazione dei file di esempio.

• La versione più recente e l'elenco completo degli esempi sono disponibili in linea alla pagina Visual Studio 2008 Samples.

• È anche possibile trovare gli esempi sul disco rigido del computer. Per impostazione predefinita, gli esempi e il file Leggimi vengono copiati in una cartella nel percorso \Programmi\Visual Studio 9.0\Samples\. Per le versioni Express di Visual Studio, tutti gli esempi sono disponibili in linea.

Generazione ed esecuzione dell'esempio

Per generare ed eseguire l'esempio ROWLIST

1. Aprire il file di soluzione rowlist.sln.

2. Scegliere Genera dal menu Genera.

3. Scegliere Avvia senza eseguire debug dal menu Debug.

Quando si esegue ROWLIST, viene presentata un'applicazione SDI la cui visualizzazione è una classe derivata CListView. Nella visualizzazione sono presenti voci che rappresentano colori diversi, con ulteriori dati su di essi. Il controllo visualizzazione elenco appare inizialmente in modalità report, con la funzionalità di selezione di intere righe attivata. Il menu Visualizza e la barra degli strumenti consentono di selezionare altre modalità di visualizzazione.

Le immagini di stato inizialmente sono impostate su un quadrato vuoto sul lato sinistro di ciascuna voce. Se si fa clic su un'immagine di stato, l'immagine della voce si trasforma in icona sulla barra del titolo. Se le immagini di stato non vengono visualizzate, è possibile fare doppio clic su una voce per modificarne lo stato.

Classe CListViewEx

La classe CListViewEx, derivata da CListView, è una classe riutilizzabile che implementa la modalità di selezione di intere righe. La classe fornisce il supporto completo per la modalità creata dal proprietario di un controllo visualizzazione elenco e fornisce la funzionalità di selezione di intere righe implementando il codice di disegno per tutte le immagini e le etichette. CListViewEx visualizza le etichette e le immagini del controllo esattamente come nella modalità report, con l'aggiunta della selezione di intere righe. La classe presenta solo due funzioni membro aggiuntive (rispetto a CListView): SetFullRowSel e GetFullRowSel. Queste funzioni vengono utilizzate per impostare o interrogare la modalità di selezione di intere righe.

È possibile utilizzare la classe nei propri progetti, implementandola direttamente o derivandone una classe. Il modo più semplice per utilizzare la classe consiste nell'eseguire la Creazione guidata applicazioni per creare un'applicazione con una classe derivata CListView e quindi di modificarne la classe base in CListViewEx.

Utilizzo di immagini sovrapposte e di stato con una classe CListView

In ROWLIST viene illustrato l'utilizzo di immagini sovrapposte e di stato. Le immagini di stato inizialmente sono impostate su un quadrato vuoto sul lato sinistro di ciascuna voce. Se si fa clic su un'immagine di stato, l'immagine della voce si trasforma in icona sulla barra del titolo. In risposta, l'icona di stato della voce si modifica in un quadrato contrassegnato da un segno di spunta. CRowListView::OnLButtonDown contiene il codice che inserisce il segno di spunta se un'icona di stato viene selezionata e che modifica un'icona di stato per una voce.

Se le immagini di stato non vengono visualizzate, l'immagine in uso verrà contrassegnata con un'immagine sovrapposta (un quadrato grigio con un segno di spunta). È possibile fare doppio clic per modificare lo stato di una voce, operazione che determina anche l'attivazione o disattivazione di un'immagine sovrapposta. Il codice di implementazione per il doppio clic si trova in CRowListView::OnLButtonDblClk.

Nota:
Alcuni esempi, tra cui il presente, non sono stati cambiati per riflettere le modifiche apportate alle procedure guidate, alle librerie e al compilatore di Visual C++, tuttavia forniscono comunque le istruzioni per completare l'attività desiderata.

Vedere anche

Altre risorse

Esempi relativi ad MFC