CImageList::DrawIndirect

Artículo
02/19/2013

Llame a esta función miembro para extraer una imagen de una imagen.

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

Parámetros

pimldp
Un puntero a una estructura de IMAGELISTDRAWPARAMS que contiene información sobre la operación de dibujo.
pDC
Un puntero al contexto del dispositivo de destino.Debe eliminar este objeto de CDC cuando termine con él.
nImage
El índice de base cero de la imagen que se va a dibujar.
pt
Una estructura de puntos que contiene las coordenadas de x e y donde la imagen se dibuja.
sz
Una estructura de CALIBRE que indica el tamaño de la imagen que se va a dibujar.
ptOrigin
Una estructura de puntos que contiene las coordenadas x e y que especifican la esquina superior izquierda de la operación de dibujo con respecto a la imagen propio.Los píxeles de la imagen que están a la izquierda de la coordenada x y sobre la coordenada y no se dibujan.
fStyle
Marcador que especifica el estilo del gráfico y, opcionalmente, la imagen de superposición.Vea la sección comentarios para obtener información sobre la imagen de superposición.La implementación predeterminada de MFC, ILD_NORMAL, dibuja la imagen utilizando el color de fondo para la lista de imágenes.Si el color de fondo es el valor de CLR_NONE , la imagen se dibuja transparente mediante una máscara.

Otros estilos posibles se describen en miembro de fStyle de la estructura de IMAGELISTDRAWPARAMS .
dwRop
valor que especifica un código de la trama-operación.Estos códigos definen cómo los datos de color del rectángulo de origen se combinan con los datos de color del rectángulo de destino cobertura color final.La implementación predeterminada de MFC, SRCCOPY, copia el rectángulo de origen directamente al rectángulo de destino.se omite este parámetro si el parámetro de fStyle no incluye el indicador de ILD_ROP .

Otros valores posibles se describen en miembro de dwRop de la estructura de IMAGELISTDRAWPARAMS .

rgbBack
el color de fondo de la imagen, de forma predeterminada CLR_DEFAULT.Este parámetro puede ser un valor RGB o definido por la aplicación de los valores siguientes:

Valor	Significado
CLR_DEFAULT	color de fondo predeterminado.La imagen se dibuja utilizando el color de fondo de la lista de imágenes.
CLR_NONE	ningún color de fondo.La imagen se dibuja transparente.

rgbFore
color de primer plano de la imagen, de forma predeterminada CLR_DEFAULT.Este parámetro puede ser un valor RGB o definido por la aplicación de los valores siguientes:

Valor	Significado
CLR_DEFAULT	color de primer plano predeterminado.La imagen se dibuja utilizando el color de resaltado del sistema como color de primer plano.
CLR_NONE	Ninguna combinación color.La imagen se mezcla con el color del contexto del dispositivo de destino.

Se utiliza este parámetro únicamente si fStyle incluye el indicador de ILD_BLEND25 o de ILD_BLEND50 .

fState
Marcador que especifica el estado del gráfico.Este miembro puede contener uno o más marcas de estado de la lista de imágenes.
Marco
Afecta al comportamiento de saturan y a efectos de la mezcla alfa.

Cuando se utiliza con ILS_SATURATE, este miembro contiene el valor que se agrega a cada componente de color de cumplen el teorema RGB para cada píxel del icono.

Cuando se utiliza con ILS_APLHA, este miembro contiene el valor para el canal alfa.Este valor puede ser comprendidos entre 0 a 255, siendo 0 completamente transparente, y 255 que son totalmente opacos.
crEffect
Un valor de COLORREF utilizado para los efectos de resplandor exterior y sombras.

Valor devuelto

TRUE si la imagen se dibuja correctamente; si no FALSO.

Comentarios

Utilice la primera versión si desea rellenar la estructura de Win32 personalmente.Utilice la segunda versión si desea aprovechar de uno o más de los argumentos predeterminados de MFC, o evítela administrar la estructura.

Una imagen de grafía es una imagen que se dibuja encima de la imagen primaria, especificada en esta función miembro por el parámetro de nImage .Dibuje una máscara de grafía utilizando la función miembro de Tablas con el índice de base uno de la máscara de grafía especificada mediante la macro de INDEXTOOVERLAYMASK .

Ejemplo

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