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 |