Struttura IMAGELISTDRAWPARAMS (commctrl.h)

  • Articolo

Contiene informazioni su un'operazione di disegno dell'elenco di immagini e viene usata con la funzione IImageList::D raw .

Sintassi

typedef struct _IMAGELISTDRAWPARAMS {
  DWORD      cbSize;
  HIMAGELIST himl;
  int        i;
  HDC        hdcDst;
  int        x;
  int        y;
  int        cx;
  int        cy;
  int        xBitmap;
  int        yBitmap;
  COLORREF   rgbBk;
  COLORREF   rgbFg;
  UINT       fStyle;
  DWORD      dwRop;
  DWORD      fState;
  DWORD      Frame;
  COLORREF   crEffect;
} IMAGELISTDRAWPARAMS, *LPIMAGELISTDRAWPARAMS;

Members

cbSize

Tipo: DWORD

Dimensioni di questa struttura, in byte.

himl

Tipo: HIMAGELIST

Handle per l'elenco di immagini che contiene l'immagine da disegnare.

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 che specifica dove viene disegnata l'immagine.

y

Tipo: int

Coordinata y che specifica dove viene disegnata l'immagine.

cx

Tipo: int

Valore che specifica il numero di pixel da disegnare, rispetto all'angolo superiore sinistro dell'operazione di disegno, come specificato da xBitmap e yBitmap. Se cx e cy sono zero, Draw disegna l'intera sezione valida. Il metodo non garantisce che i parametri siano validi.

cy

Tipo: int

Valore che specifica il numero di pixel da disegnare, rispetto all'angolo superiore sinistro dell'operazione di disegno, come specificato da xBitmap e yBitmap. Se cx e cy sono zero, Draw disegna l'intera sezione valida. Il metodo non garantisce che i parametri siano validi.

xBitmap

Tipo: int

Coordinata x che specifica l'angolo superiore sinistro dell'operazione di disegno in riferimento all'immagine stessa. I pixel dell'immagine a sinistra di xBitmap e sopra yBitmap non vengono visualizzati.

yBitmap

Tipo: int

Coordinata y che specifica l'angolo superiore sinistro dell'operazione di disegno in riferimento all'immagine stessa. I pixel dell'immagine a sinistra di xBitmap e sopra yBitmap non vengono visualizzati.

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_DEFAULT
 Colore di sfondo predefinito. L'immagine viene disegnata usando il colore di sfondo dell'elenco di immagini.
CLR_NONE
 Nessun colore di sfondo. L'immagine viene disegnata in modo trasparente.

rgbFg

Tipo: COLORREF

Colore di primo piano dell'immagine. Questo membro viene usato solo se fStyle include il flag di ILD_BLEND25 o di ILD_BLEND50 . Questo parametro può essere un valore RGB definito dall'applicazione o uno dei valori seguenti:

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

fStyle

Tipo: UINT

Flag che specifica lo stile di disegno e, facoltativamente, l'immagine di sovrapposizione. Per informazioni sull'immagine di sovrapposizione, vedere la sezione commenti alla fine di questo argomento. Questo membro può contenere uno o più flag di disegno dell'elenco di immagini.

dwRop

Tipo: DWORD

Valore che specifica un codice di operazione raster. Questi codici definiscono il modo in cui i dati di colore per il rettangolo di origine verranno combinati con i dati di colore per il rettangolo di destinazione per ottenere il colore finale. Questo membro viene ignorato se fStyle non include il flag di ILD_ROP . Alcuni codici di operazione raster comuni includono:

Valore Significato
OSCURITÀ
 Riempie il rettangolo di destinazione usando il colore associato all'indice zero nella tavolozza fisica. Nella tavolozza fisica predefinita questo colore è il nero.
DSTINVERT
 Inverte il rettangolo di destinazione.
MERGECOPY
 Unisce i colori del rettangolo di origine con il modello specificato usando l'operatore AND booleano.
MERGEPAINT
 Unisce i colori del rettangolo di origine invertito con i colori del rettangolo di destinazione usando l'operatore OR booleano.
NOTSRCCOPY
 Copia il rettangolo di origine invertito nella destinazione.
NOTSRCERASE
 Combina i colori del rettangolo di origine e di destinazione usando l'operatore OR booleano. Inverte il colore risultante.
PATCOPY
 Copia il modello specificato nella bitmap di destinazione.
PATINVERT
 Combina i colori del modello specificati con i colori del rettangolo di destinazione usando l'operatore XOR booleano.
PATPAINT
 Combina i colori del modello con i colori del rettangolo di origine invertito e combina il risultato con i colori del rettangolo di destinazione usando l'operatore OR booleano.
SRCAND
 Combina i colori del rettangolo di origine e di destinazione usando l'operatore AND booleano.
SRCCOPY
 Copia il rettangolo di origine direttamente nel rettangolo di destinazione.
SRCERASE
 Combina i colori invertiti del rettangolo di destinazione con i colori del rettangolo di origine usando l'operatore AND booleano.
SRCINVERT
 Combina i colori del rettangolo di origine e di destinazione usando l'operatore XOR booleano.
SRCPAINT
 Combina i colori del rettangolo di origine e di destinazione usando l'operatore OR booleano.
BIANCHEZZA
 Riempie il rettangolo di destinazione usando il colore associato all'indice 1 nella tavolozza fisica. Questo colore è bianco per la tavolozza fisica predefinita.

fState

Tipo: DWORD

Flag che specifica lo stato di disegno. Questo membro può contenere uno o più flag di stato dell'elenco di immagini. È necessario usare comctl32.dll versione 6 per usare questo membro. Vedere le osservazioni.

Frame

Tipo: DWORD

Usato con l'effetto di fusione alfa .

Se usato con ILS_ALPHA, questo membro contiene il valore per il canale alfa. Questo valore può essere compreso tra 0 e 255, con 0 completamente trasparente e 255 completamente opaco.

È necessario usare comctl32.dll versione 6 per usare questo membro. Vedere le osservazioni.

crEffect

Tipo: DWORD

Colore utilizzato per gli effetti di luminosità e ombreggiatura . È necessario usare comctl32.dll versione 6 per usare questo membro. Vedere le osservazioni.

Commenti

Un'immagine di sovrapposizione è un'immagine disegnata sopra l'immagine primaria specificata nel membro i di questa struttura. Per specificare un'immagine di sovrapposizione, usare l'operatore OR bit per combinare fStyle con la macro INDEXTOOVERLAYMASK , passando l'indice in base uno dell'immagine di sovrapposizione nella macro. Questa immagine deve essere stata specificata in precedenza come immagine di sovrapposizione usando l'API ImageList_SetOverlayImage .

Per estrarre l'immagine di sovrapposizione da fStyle, usare l'operatore AND bit per mascherare fStyle con il valore ILD_OVERLAYMASK .

Comctl32.dll versione 6 non è ridistribuibile. Per usare Comctl32.dll versione 6, è necessario specificarlo in un manifesto. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione commctrl.h (includere Commctrl.h)