CImageList::DrawIndirect

Articolo
03/05/2013

Chiamare la funzione membro per disegnare un'immagine da un elenco.

BOOL DrawIndirect(
   IMAGELISTDRAWPARAMS* pimldp 
);
BOOL DrawIndirect(
   CDC* pDC,
   int nImage,
   POINT pt,
   SIZE sz,
   POINT ptOrigin,
   UINT fStyle = ILD_NORMAL,
   DWORD dwRop = SRCCOPY,
   COLORREF rgbBack = CLR_DEFAULT,
   COLORREF rgbFore = CLR_DEFAULT,
   DWORD fState = ILS_NORMAL,
   DWORD Frame = 0,
   COLORREF crEffect = CLR_DEFAULT
);

Parametri

pimldp
Un puntatore a una struttura IMAGELISTDRAWPARAMS che contiene informazioni sull'operazione di disegno.
pDC
Un puntatore al contesto di dispositivo di destinazione.È necessario eliminare l'oggetto CDC quando l'operazione è stata eseguita.
nImage
Indice in base zero dell'immagine da tracciare.
pt
Una struttura QUESTION contenente le coordinate x e y in cui l'immagine viene disegnata.
sz
Una struttura DIMENSIONE che indica la dimensione dell'immagine da tracciare.
ptOrigin
Una struttura QUESTION contenente le coordinate x e y che specificano l'angolo superiore sinistro dell'operazione di disegno sull'immagine stesso.I pixel dell'immagine che sono a sinistra della coordinata x e sulla coordinata y non vengono disegnati.
fStyle
Contrassegnare specificare lo stile di disegno e, facoltativamente, l'immagine sovrapposta.Vedere la sezione relativa alle osservazioni per informazioni su un'immagine sovrapposta.L'implementazione predefinita di MFC, ILD_NORMAL, l'immagine viene disegnata utilizzando il colore di sfondo dell'elenco.Se il colore di sfondo è il valore CLR_NONE, viene disegnata trasparente utilizzando una maschera.

Altri stili possibili sono descritti nel membro fStyle della struttura IMAGELISTDRAWPARAMS.
dwRop
Valore che specifica un codice di un'operazione raster.Questi codici definiscono come i dati di colore per il rettangolo di origine vengono combinate con i dati del colore del rettangolo di destinazione raggiungono il colore finale.L'implementazione predefinita di MFC, SRCCOPY, copia del rettangolo di origine direttamente al rettangolo di destinazione.Questo parametro viene ignorato se il parametro fStyle non include il flag ILD_ROP.

Altri valori possibili sono descritti nel membro dwRop della struttura IMAGELISTDRAWPARAMS.

rgbBack
Il colore di sfondo di immagine, per impostazione predefinita CLR_DEFAULT.Questo parametro può essere definito da un valore RGB o dei valori seguenti:

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

rgbFore
Colore di primo piano immagine, per impostazione predefinita CLR_DEFAULT.Questo parametro può essere definito da un valore RGB o dei valori seguenti:

Valore	Significato
CLR_DEFAULT	Colore di primo piano predefinito.L'immagine viene disegnata con il colore evidenziatore di sistema come colore di primo piano.
CLR_NONE	Nessun colore di combinazione.L'immagine viene sfumata con il colore del contesto di dispositivo di destinazione.

Questo parametro viene utilizzato solo se fStyle include il flag ILD_BLEND50 o ILD_BLEND25.

fState
Flag che specifica lo stato di disegno.Questo membro può contenere uno o più flag dello stato dell'elenco.
Frame
Influisce sul comportamento di saturano e gli effetti di fusione alfa.

Se utilizzato con ILS_SATURATE, questo membro viene utilizzato il valore che viene aggiunto a ogni componente cromatica di una terna RGB per ciascun pixel dell'icona.

Se utilizzato con ILS_APLHA, questo membro viene utilizzato il valore per il canale alfa.Questo valore può essere compreso tra 0 e 255, dove 0 è completamente trasparente e 255 che sono completamente opachi.
crEffect
Un valore COLORREF utilizzato per alone e di effetti di ombreggiatura.

Valore restituito

TRUE se l'immagine venga disegnata, in caso contrario FALSE.

Note

Utilizzare la prima versione se si desidera riempire la struttura Win32 manualmente.Utilizzare la seconda versione se si desidera sfruttare di uno o più argomenti dell'impostazione predefinita di MFC, o di gestire la struttura.

Un'immagine sovrapposta è un'immagine che viene disegnato sopra l'immagine primaria, specificata nella funzione membro dal parametro nImage.Creare una maschera di sovrapposizione utilizzando la funzione membro Disegno con indice in base uno maschera di sovrapposizione specificata utilizzando la macro INDEXTOOVERLAYMASK.

Esempio

int i, dx, cx, cy, nCount = m_myImageList.GetImageCount();

::ImageList_GetIconSize(m_myImageList, &cx, &cy);

// Draw the images of the image list on the DC.
for (dx = 0, i = 0; i < nCount; i++)
{
   m_myImageList.DrawIndirect(&dc, i, CPoint(dx, 0), 
      CSize(cx, cy), CPoint(0, 0));
   dx += cx;
}