Image::GetThumbnailImage-Methode (gdiplusheaders.h)

Die Image::GetThumbnailImage-Methode ruft ein Miniaturbild aus diesem Image-Objekt ab.

Syntax

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

Parameter

[in] thumbWidth

Typ: UINT

Breite des angeforderten Miniaturbilds in Pixel.

[in] thumbHeight

Typ: UINT

Höhe des angeforderten Miniaturbilds in Pixel.

[in] callback

Typ: GetThumbnailImageAbort

Optional. Die von Ihnen bereitgestellte Rückruffunktion. Während des Erstellens oder Abrufens des Miniaturbilds ruft GDI+ diese Funktion auf, um Ihnen die Möglichkeit zu geben, den Prozess abzubrechen. Der Standardwert ist NULL.

callbackData

Typ: VOID*

Optional. Zeiger auf einen Speicherblock, der Daten enthält, die von der Rückruffunktion verwendet werden sollen. Der Standardwert ist NULL.

Rückgabewert

Typ: Bild*

Diese Methode gibt einen Zeiger auf ein Image-Objekt zurück, das das Miniaturbild enthält.

Hinweise

Ein Miniaturbild ist eine kleine Kopie eines Bilds. Bei einigen Bilddateien ist ein Miniaturbild in die Datei eingebettet. In solchen Fällen ruft diese Methode das eingebettete Miniaturbild ab. Wenn kein eingebettetes Miniaturansichtsbild vorhanden ist, erstellt diese Methode ein Miniaturbild, indem das Standard Bild auf die größe skaliert wird, die in den Parametern thumbWidth und thumbHeight angegeben ist. Wenn beide Parameter 0 sind, wird eine systemdefinierte Größe verwendet.

Beispiele

Im folgenden Beispiel wird ein Image-Objekt basierend auf einer JPEG-Datei erstellt. Der Code ruft die Image::GetThumbnailImage-Methode dieses Image-Objekts auf und zeigt dann das Miniaturbild zusammen mit dem Standard Bild an.

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;

}

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll

Weitere Informationen

Bitmap

Erstellen von Miniaturansichten

Bild

Bilder, Bitmaps und Metadateien