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:

rgbFg

Tipo: COLORREF

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

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 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