Image::GetThumbnailImage, méthode (gdiplusheaders.h)

  • Article

La méthode Image::GetThumbnailImage obtient une image miniature à partir de cet objet Image .

Syntaxe

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

Paramètres

[in] thumbWidth

Type : UINT

Largeur, en pixels, de l’image miniature demandée.

[in] thumbHeight

Type : UINT

Hauteur, en pixels, de l’image miniature demandée.

[in] callback

Type : GetThumbnailImageAbort

Optionnel. Fonction de rappel que vous fournissez. Pendant le processus de création ou de récupération de l’image miniature, GDI+ appelle cette fonction pour vous donner la possibilité d’abandonner le processus. La valeur par défaut est NULL.

callbackData

Type : VOID*

Optionnel. Pointeur vers un bloc de mémoire qui contient des données à utiliser par la fonction de rappel. La valeur par défaut est NULL.

Valeur retournée

Type : Image*

Cette méthode retourne un pointeur vers un objet Image qui contient l’image miniature.

Notes

Une image miniature est une petite copie d’une image. Certains fichiers image ont une image miniature incorporée dans le fichier. Dans ce cas, cette méthode récupère l’image miniature incorporée. S’il n’existe aucune image miniature incorporée, cette méthode crée une image miniature en mettant à l’échelle l’image main à la taille spécifiée dans les paramètres thumbWidth et thumbHeight. Si ces deux paramètres sont 0, une taille définie par le système est utilisée.

Exemples

L’exemple suivant crée un objet Image basé sur un fichier JPEG. Le code appelle la méthode Image::GetThumbnailImage de cet objet Image, puis affiche l’image miniature avec l’image 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;

}

Configuration requise

   
Client minimal pris en charge Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête gdiplusheaders.h (inclure Gdiplus.h)
Bibliothèque Gdiplus.lib
DLL Gdiplus.dll

Voir aussi

Bitmap

Création d’images miniatures

Image

Images, bitmaps et métafichiers