Metodo Image::GetThumbnailImage (gdiplusheaders.h)

Articolo
08/24/2023

Il metodo Image::GetThumbnailImage ottiene un'immagine di anteprima da questo oggetto Image .

Sintassi

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

Parametri

[in] thumbWidth

Tipo: UINT

Larghezza, in pixel, dell'immagine di anteprima richiesta.

[in] thumbHeight

Tipo: UINT

Altezza, in pixel, dell'immagine di anteprima richiesta.

[in] callback

Tipo: GetThumbnailImageAbort

Facoltativa. Funzione di callback specificata. Durante il processo di creazione o recupero dell'immagine di anteprima, GDI+ chiama questa funzione per consentire l'interruzione del processo. Il valore predefinito è NULL.

callbackData

Tipo: VOID*

Facoltativa. Puntatore a un blocco di memoria che contiene dati da usare dalla funzione di callback. Il valore predefinito è NULL.

Valore restituito

Tipo: Immagine*

Questo metodo restituisce un puntatore a un oggetto Image contenente l'immagine di anteprima.

Commenti

Un'immagine di anteprima è una piccola copia di un'immagine. Alcuni file di immagine hanno un'immagine di anteprima incorporata nel file. In questi casi, questo metodo recupera l'immagine di anteprima incorporata. Se non è presente un'immagine di anteprima incorporata, questo metodo crea un'immagine di anteprima ridimensionando l'immagine principale alle dimensioni specificate nei parametri thumbWidth e thumbHeight . Se entrambi i parametri sono 0, viene usata una dimensione definita dal sistema.

Esempio

Nell'esempio seguente viene creato un oggetto Image basato su un file JPEG. Il codice chiama il metodo Image::GetThumbnailImage dell'oggetto Image e quindi visualizza l'immagine di anteprima insieme all'immagine principale.

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;

}

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusheaders.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll