Elenchi di immagini

Questa sezione contiene informazioni sugli elementi di programmazione usati con gli elenchi di immagini.

Panoramiche

Argomento	Contenuto
Elenchi di immagini	Un elenco di immagini è una raccolta di immagini con le stesse dimensioni, ognuna delle quali può essere definita dal relativo indice.

Funzioni

Argomento	Contenuto
HIMAGELIST_QueryInterface	Recupera un puntatore a un oggetto IImageList o IImageList2 che corrisponde all'handle HIMAGELIST dell'elenco di immagini.
ImageList_Add	Aggiunge un'immagine o immagini a un elenco di immagini.
ImageList_AddMasked	Aggiunge un'immagine o un'immagine a un elenco di immagini, generando una maschera dalla bitmap specificata.
ImageList_BeginDrag	Inizia a trascinare un'immagine.
ImageList_CoCreateInstance	Crea una singola istanza di un elenco di immagini e restituisce un puntatore all'interfaccia.
ImageList_Copy	Copia le immagini all'interno di un determinato elenco di immagini.
ImageList_Create	Crea un nuovo elenco di immagini.
ImageList_Destroy	Elimina definitivamente un elenco di immagini.
ImageList_DragEnter	Visualizza l'immagine di trascinamento nella posizione specificata all'interno della finestra.
ImageList_DragLeave	Sblocca la finestra specificata e nasconde l'immagine di trascinamento, consentendo l'aggiornamento della finestra.
ImageList_DragMove	Sposta l'immagine trascinata durante un'operazione di trascinamento della selezione. Questa funzione viene in genere chiamata in risposta a un messaggio WM_MOUedizione Standard MOVE.
ImageList_DragShowNolock	Mostra o nasconde l'immagine trascinata.
ImageList_Draw	Disegna una voce di elenco di immagini nel contesto di dispositivo specificato.
ImageList_DrawEx	Disegna una voce di elenco di immagini nel contesto di dispositivo specificato. La funzione usa lo stile di disegno specificato e fonde l'immagine con il colore specificato.
ImageList_DrawIndirect	Disegna un'immagine dell'elenco di immagini basata su una struttura IMAGELISTDRAWPARAMS.
ImageList_Duplicate	Crea un duplicato di un elenco di immagini esistente.
ImageList_EndDrag	Termina un'operazione di trascinamento.
ImageList_GetBkColor	Recupera il colore di sfondo corrente per un elenco di immagini.
ImageList_GetDragImage	Recupera l'elenco di immagini temporanee utilizzato per l'immagine di trascinamento. La funzione recupera anche la posizione di trascinamento corrente e l'offset dell'immagine di trascinamento rispetto alla posizione di trascinamento.
ImageList_GetIcon	Crea un'icona da un'immagine e una maschera in un elenco di immagini.
ImageList_GetIconSize	Recupera le dimensioni delle immagini in un elenco di immagini. Tutte le immagini in un elenco di immagini hanno le stesse dimensioni.
ImageList_GetImageCount	Recupera il numero di immagini in un elenco di immagini.
ImageList_GetImageInfo	Recupera informazioni su un'immagine.
ImageList_LoadImage	Crea un elenco di immagini dalla bitmap specificata.
ImageList_Merge	Crea una nuova immagine combinando due immagini esistenti. La funzione crea anche un nuovo elenco di immagini in cui archiviare l'immagine.
ImageList_Read	Legge un elenco di immagini da un flusso.
ImageList_ReadEx	Legge un elenco di immagini da un flusso e restituisce un'interfaccia all'elenco di immagini.
ImageList_Remove	Rimuove un'immagine da un elenco di immagini.
ImageList_Replace	Sostituisce un'immagine in un elenco di immagini con una nuova immagine.
ImageList_ReplaceIcon	Sostituisce un'immagine con un'icona o un cursore.
ImageList_SetBkColor	Imposta il colore di sfondo per un elenco di immagini. Questa funzione funziona solo se si aggiunge un'icona o si usa ImageList_AddMasked con una bitmap bianca e nera. Senza maschera, viene disegnata l'intera immagine; pertanto il colore di sfondo non è visibile.
ImageList_SetColorTable	Imposta la tabella dei colori per un elenco di immagini.
ImageList_SetDragCursorImage	Crea una nuova immagine di trascinamento combinando l'immagine specificata (in genere un'immagine del cursore del mouse) con l'immagine di trascinamento corrente.
ImageList_SetIconSize	Imposta le dimensioni delle immagini in un elenco di immagini e rimuove tutte le immagini dall'elenco.
ImageList_SetImageCount	Ridimensiona un elenco di immagini esistente.
ImageList_SetOverlayImage	Aggiunge un'immagine specificata all'elenco di immagini da usare come maschere di sovrapposizione. Un elenco di immagini può avere fino a quattro maschere sovrapposte nella versione 4.70 e precedenti e fino a 15 nella versione 4.71. La funzione assegna un indice della maschera di sovrimpressione all'immagine specificata.
ImageList_Write	Scrive un elenco di immagini in un flusso.
ImageList_WriteEx	Scrive un elenco di immagini in un flusso.

Macro

Argomento	Contenuto
ImageList_AddIcon	Aggiunge un'icona o un cursore a un elenco di immagini. ImageList_AddIcon chiama la funzione ImageList_ReplaceIcon.
ImageList_ExtractIcon	Chiama la funzione ImageList_GetIcon per creare un'icona o un cursore in base a un'immagine e una maschera in un elenco di immagini.
ImageList_LoadBitmap	Chiama la funzione ImageList_LoadImage per creare un elenco di immagini dalla risorsa bitmap specificata.
ImageList_RemoveAll	Chiama la funzione ImageList_Remove per rimuovere tutte le immagini da un elenco di immagini.
INDEXTOOVERLAYMASK	Prepara l'indice di una maschera di sovrimpressione in modo che la funzione ImageList_Draw possa usarla.

Interfacce

Argomento

Contenuto

IImageList

Espone metodi che modificano e interagiscono con gli elenchi di immagini. Per usare IImageList, specificare Comctl32.dll versione 6 nel manifesto. Se non si esegue questa operazione, Comctl32.dll versione 5 verrà usata per impostazione predefinita, con cui IImageList potrebbe visualizzare un comportamento imprevedibile. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.

Metodi

Argomento	Contenuto
Aggiunta	Aggiunge un'immagine o immagini a un elenco di immagini.
AddMasked	Aggiunge un'immagine o un'immagine a un elenco di immagini, generando una maschera dalla bitmap specificata.
BeginDrag	Inizia a trascinare un'immagine.
Clona	Clona un elenco di immagini esistente.
Copia	Copia le immagini da un determinato elenco di immagini.
Dragenter	Blocca gli aggiornamenti alla finestra specificata durante un'operazione di trascinamento e visualizza l'immagine di trascinamento nella posizione specificata all'interno della finestra.
Dragleave	Sblocca la finestra specificata e nasconde l'immagine di trascinamento, che consente di aggiornare la finestra.
DragMove	Sposta l'immagine trascinata durante un'operazione di trascinamento della selezione. Questa funzione viene in genere chiamata in risposta a un messaggio WM_MOUedizione Standard MOVE.
DragShowNolock	Mostra o nasconde l'immagine trascinata.
Disegnare	Disegna una voce di elenco di immagini nel contesto di dispositivo specificato.
EndDrag	Termina un'operazione di trascinamento.
GetBkColor	Ottiene il colore di sfondo corrente per un elenco di immagini.
GetDragImage	Ottiene l'elenco di immagini temporanee utilizzato per l'immagine di trascinamento. La funzione recupera anche la posizione di trascinamento corrente e l'offset dell'immagine di trascinamento rispetto alla posizione di trascinamento.
GetIcon	Crea un'icona da un'immagine e una maschera in un elenco di immagini.
GetIconSize	Ottiene le dimensioni delle immagini in un elenco di immagini. Tutte le immagini in un elenco di immagini hanno le stesse dimensioni.
GetImageCount	Ottiene il numero di immagini in un elenco di immagini.
GetImageInfo	Ottiene informazioni su un'immagine.
GetImageRect	Ottiene il rettangolo di delimitazione di un'immagine.
GetItemFlags	Ottiene i flag di un'immagine.
GetOverlayImage	Recupera un'immagine specificata dall'elenco di immagini usate come maschere di sovrapposizione.
Unione	Crea una nuova immagine combinando due immagini esistenti. Questo metodo crea anche un nuovo elenco di immagini in cui archiviare l'immagine.
Rimuovi	Rimuove un'immagine da un elenco di immagini.
Sostituzione	Sostituisce un'immagine in un elenco di immagini con una nuova immagine.
ReplaceIcon	Sostituisce un'immagine con un'icona o un cursore.
SetBkColor	Imposta il colore di sfondo per un elenco di immagini. Questo metodo funziona solo se si aggiunge un'icona all'elenco di immagini o si usa il metodo IImageList::AddMasked per aggiungere una bitmap nera e bianca. Senza maschera, l'intera immagine disegna e il colore di sfondo non è visibile.
SetDragCursorImage	Crea una nuova immagine di trascinamento combinando l'immagine specificata, che in genere è un'immagine del cursore del mouse, con l'immagine di trascinamento corrente.
SetIconSize	Imposta le dimensioni delle immagini in un elenco di immagini e rimuove tutte le immagini dall'elenco.
SetImageCount	Ridimensiona un elenco di immagini esistente.
SetOverlayImage	Aggiunge un'immagine specificata all'elenco di immagini usate come maschere di sovrapposizione. Un elenco di immagini può avere fino a quattro maschere sovrapposte in Controlli comuni versione 4.70 e precedenti e fino a 15 nella versione 4.71 o successiva. Il metodo assegna un indice della maschera di sovrimpressione all'immagine specificata.

Strutture

Argomento	Contenuto
IMAGEINFO	Contiene informazioni su un'immagine in un elenco di immagini. Questa struttura viene usata con la funzione IImageList::GetImageInfo.
IMAGELISTDRAWPARAMS	Contiene informazioni su un'operazione di disegno dell'elenco di immagini e viene utilizzata con la funzione IImageList::D raw .