Image::GetThumbnailImage, méthode (gdiplusheaders.h)
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 |