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

O método Image::GetThumbnailImage obtém uma imagem em miniatura deste objeto Image .

Sintaxe

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

Parâmetros

[in] thumbWidth

Tipo: UINT

Largura, em pixels, da imagem de miniatura solicitada.

[in] thumbHeight

Tipo: UINT

Altura, em pixels, da imagem de miniatura solicitada.

[in] callback

Tipo: GetThumbnailImageAbort

Opcional. Função de retorno de chamada que você fornece. Durante o processo de criação ou recuperação da imagem em miniatura, o GDI+ chama essa função para lhe dar a oportunidade de anular o processo. O valor padrão é NULL.

callbackData

Tipo: VOID*

Opcional. Ponteiro para um bloco de memória que contém dados a serem usados pela função de retorno de chamada. O valor padrão é NULL.

Valor retornado

Tipo: Imagem*

Esse método retorna um ponteiro para um objeto Image que contém a imagem em miniatura.

Comentários

Uma imagem em miniatura é uma pequena cópia de uma imagem. Alguns arquivos de imagem têm uma imagem em miniatura inserida no arquivo. Nesses casos, esse método recupera a imagem de miniatura inserida. Se não houver nenhuma imagem de miniatura inserida, esse método criará uma imagem em miniatura dimensionando a imagem main para o tamanho especificado nos parâmetros thumbWidth e thumbHeight. Se ambos os parâmetros forem 0, um tamanho definido pelo sistema será usado.

Exemplos

O exemplo a seguir cria um objeto Image com base em um arquivo JPEG. O código chama o método Image::GetThumbnailImage desse objeto Image e exibe a imagem em miniatura junto com a imagem main.

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 com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll

Confira também

Bitmap

Criando imagens em miniatura

Imagem

Imagens, Bitmaps e Metafiles