Funzione ImageList_Draw (commctrl.h)

Disegna un elemento dell'elenco di immagini nel contesto del dispositivo specificato.

Sintassi

BOOL ImageList_Draw(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  UINT       fStyle
);

Parametri

himl

Tipo: HIMAGELIST

Handle per l'elenco di immagini.

i

Tipo: int

Indice in base zero dell'immagine da disegnare.

hdcDst

Tipo: HDC

Handle al contesto del dispositivo di destinazione.

x

Tipo: int

Coordinata x in corrispondenza della quale disegnare all'interno del contesto del dispositivo specificato.

y

Tipo: int

Coordinata y in corrispondenza della quale disegnare all'interno del contesto del dispositivo specificato.

fStyle

Tipo: UINT

Stile di disegno e, facoltativamente, immagine di sovrapposizione. Per informazioni sulla specifica di un indice di immagine di sovrapposizione, vedere la sezione commenti alla fine di questo argomento. Questo parametro può essere una combinazione di un indice di immagine di sovrapposizione e uno o più dei valori seguenti:

Valore	Significato
ILD_BLEND
ILD_BLEND25	Disegna l'immagine, fondendo il 25% con il colore di evidenziazione del sistema. Questo valore non ha alcun effetto se l'elenco di immagini non contiene una maschera.
ILD_BLEND50	Disegna l'immagine, fondendo il 50% con il colore di evidenziazione del sistema. Questo valore non ha alcun effetto se l'elenco di immagini non contiene una maschera.
ILD_FOCUS
ILD_IMAGE	Impostare questo flag se la sovrapposizione non richiede che venga disegnata una maschera. Questo flag causa ImageList_DrawEx di disegnare solo l'immagine, ignorando la maschera.
ILD_MASK	Disegna la maschera.
ILD_NORMAL	Disegna l'immagine usando il colore di sfondo per l'elenco di immagini. Se il colore di sfondo è il valore CLR_NONE, l'immagine viene disegnata in modo trasparente usando la maschera.
ILD_SELECTED
ILD_TRANSPARENT	Disegna l'immagine in modo trasparente usando la maschera, indipendentemente dal colore di sfondo. Questo valore non ha alcun effetto se l'elenco di immagini non contiene una maschera.

Valore restituito

Tipo: BOOL

Restituisce un valore diverso da zero se ha esito positivo o zero in caso contrario.

Commenti

Un'immagine di sovrapposizione viene disegnata in modo trasparente sull'immagine primaria specificata nel parametro i . Per specificare un'immagine di sovrapposizione nel parametro fStyle , usare la macro INDEXTOOVERLAYMASK per spostare l'indice in base uno dell'immagine di sovrapposizione. Usare l'operatore OR per combinare logicamente il valore restituito della macro con i flag di stile di disegno specificati nel parametro fStyle . È prima necessario specificare questa immagine come immagine di sovrapposizione usando la funzione ImageList_SetOverlayImage .

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h
Libreria	Comctl32.lib
DLL	Comctl32.dll
Set di API	ext-ms-win-shell-comctl32-init-l1-1-1 (introdotta in Windows 10, versione 10.0.14393)