funzione ImageList_DrawEx (commctrl.h)

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.

Sintassi

BOOL ImageList_DrawEx(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  int        dx,
  int        dy,
  COLORREF   rgbBk,
  COLORREF   rgbFg,
  UINT       fStyle
);

Parametri

himl

Tipo: HIMAGELIST

Handle per l'elenco di immagini

i

Tipo: int

Indice dell'immagine da disegnare.

hdcDst

Tipo: HDC

Handle per il contesto del dispositivo di destinazione.

x

Tipo: int

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

y

Tipo: int

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

dx

Tipo: int

Larghezza della parte dell'immagine da disegnare rispetto all'angolo superiore sinistro dell'immagine. Se dx e dy sono zero, la funzione disegna l'intera immagine. La funzione non garantisce che i parametri siano validi.

dy

Tipo: int

Altezza della parte dell'immagine da disegnare, rispetto all'angolo superiore sinistro dell'immagine. Se dx e dy sono zero, la funzione disegna l'intera immagine. La funzione non garantisce che i parametri siano validi.

rgbBk

Tipo: COLORREF

Colore di sfondo dell'immagine. Questo parametro può essere un valore RGB definito dall'applicazione o uno dei valori seguenti:

Valore	Significato
CLR_NONE	Nessun colore di sfondo. L'immagine viene disegnata in modo trasparente.
CLR_DEFAULT	Colore di sfondo predefinito. L'immagine viene disegnata usando il colore di sfondo dell'elenco di immagini.

rgbFg

Tipo: COLORREF

Colore di primo piano dell'immagine. Questo parametro può essere un valore RGB definito dall'applicazione o uno dei valori seguenti:

Valore	Significato
CLR_NONE	Nessun colore di fusione. L'immagine viene combinata con il colore del contesto del dispositivo di destinazione.
CLR_DEFAULT	Colore di primo piano predefinito. L'immagine viene disegnata usando il colore di evidenziazione del sistema come colore di primo piano.

fStyle

Tipo: UINT

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

Valore	Significato
ILD_BLEND
ILD_BLEND25	Disegna l'immagine, fondendo il 25% con il colore di fusione specificato da rgbFg. 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 fusione specificato da rgbFg. Questo valore non ha alcun effetto se l'elenco di immagini non contiene una maschera.
ILD_FOCUS
ILD_IMAGE	Impostare questo flag se la sovrimpressione non richiede che venga disegnata una maschera. Questo flag fa sì che ImageList_DrawEx disegnare solo l'immagine, ignorando la maschera.
ILD_MASK	Disegna la maschera.
ILD_NORMAL	Disegna l'immagine utilizzando 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 l'operazione 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 sovrimpressione nel parametro fStyle , usare la macro INDEXTOOVERLAYMASK per spostare l'indice in base uno dell'immagine di sovrimpressione. Utilizzare l'operatore OR per combinare logicamente il valore restituito della macro con i flag di stile di disegno specificati nel parametro fStyle . È innanzitutto 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