Método Image::GetThumbnailImage (gdiplusheaders.h)

El método Image::GetThumbnailImage obtiene una imagen en miniatura de este objeto Image .

Sintaxis

Image * GetThumbnailImage(
  [in] UINT                   thumbWidth,
  [in] UINT                   thumbHeight,
  [in] GetThumbnailImageAbort callback,
       VOID                   *callbackData
);

Parámetros

[in] thumbWidth

Tipo: UINT

Ancho, en píxeles, de la imagen en miniatura solicitada.

[in] thumbHeight

Tipo: UINT

Alto, en píxeles, de la imagen en miniatura solicitada.

[in] callback

Tipo: GetThumbnailImageAbort

Opcional. Función de devolución de llamada que proporcione. Durante el proceso de creación o recuperación de la imagen en miniatura, GDI+ llama a esta función para darle la oportunidad de anular el proceso. El valor predeterminado es NULL.

callbackData

Tipo: VOID*

Opcional. Puntero a un bloque de memoria que contiene los datos que va a usar la función de devolución de llamada. El valor predeterminado es NULL.

Valor devuelto

Tipo: Imagen*

Este método devuelve un puntero a un objeto Image que contiene la imagen en miniatura.

Comentarios

Una imagen en miniatura es una pequeña copia de una imagen. Algunos archivos de imagen tienen una imagen en miniatura incrustada en el archivo. En tales casos, este método recupera la imagen en miniatura incrustada. Si no hay ninguna imagen en miniatura incrustada, este método crea una imagen en miniatura mediante el escalado de la imagen principal al tamaño especificado en los parámetros thumbWidth y thumbHeight . Si ambos parámetros son 0, se usa un tamaño definido por el sistema.

Ejemplos

En el ejemplo siguiente se crea un objeto Image basado en un archivo JPEG. El código llama al método Image::GetThumbnailImage de ese objeto Image y, a continuación, muestra la imagen en miniatura junto con la imagen principal.

VOID Example_GetThumbnail(HDC hdc)
{
   Graphics graphics(hdc);

   // Create an image and a thumbnail of the image.
   Image image(L"Crayons.jpg");
   Image* pThumbnail = image.GetThumbnailImage(40, 40, NULL, NULL);

   // Draw the original and the thumbnail images.
   graphics.DrawImage(&image, 10, 10, image.GetWidth(), image.GetHeight());
   graphics.DrawImage(
      pThumbnail, 
      150, 
      10, 
      pThumbnail->GetWidth(), 
      pThumbnail->GetHeight());

   delete pThumbnail;

}

Requisitos

Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusheaders.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll

Consulte también

Bitmap

Creación de imágenes en miniatura

Imagen

Imágenes, mapas de bits y metarchivos