(0) exportieren Drucken
Alle erweitern

Image.GetThumbnailImage-Methode

Gibt eine Miniaturansicht für dieses Image zurück.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

public Image GetThumbnailImage (
	int thumbWidth,
	int thumbHeight,
	GetThumbnailImageAbort callback,
	IntPtr callbackData
)
public Image GetThumbnailImage (
	int thumbWidth, 
	int thumbHeight, 
	GetThumbnailImageAbort callback, 
	IntPtr callbackData
)
public function GetThumbnailImage (
	thumbWidth : int, 
	thumbHeight : int, 
	callback : GetThumbnailImageAbort, 
	callbackData : IntPtr
) : Image

Parameter

thumbWidth

Die Breite der angeforderten Miniaturansicht in Pixel.

thumbHeight

Die Höhe der angeforderten Miniaturansicht in Pixel.

callback

Ein Image.GetThumbnailImageAbort-Delegat. In GDI+, Version 1.0, wird der Delegat nicht verwendet. Sie müssen trotzdem einen Delegaten erstellen und einen Verweis auf diesen in diesem Parameter übergeben.

callbackData

Dieser Wert muss Zero sein.

Rückgabewert

Ein Image, das die Miniaturansicht darstellt.

Wenn das Image eine eingebettete Miniaturansicht enthält, ruft diese Methode die eingebettete Miniaturansicht ab und skaliert sie auf die angeforderte Größe. Wenn das Image keine eingebettete Miniaturansicht enthält, erstellt diese Methode eine Miniaturansicht durch Skalierung des Hauptbilds.

Die GetThumbnailImage-Methode wird für eine Größe der angeforderten Miniaturansicht von ca. 120 x 120 Pixel empfohlen. Wenn eine große Miniaturansicht (z. B. 300 x 300) von einem Image angefordert wird, das über eine eingebettete Miniaturansicht verfügt, zieht dies möglicherweise einen deutlichen Qualitätsverlust der Miniaturansicht nach sich. Es kann ggf. ratsam sein, das Hauptbild anstelle der eingebetteten Miniaturansicht zu skalieren, indem Sie DrawImage aufrufen.

Im folgenden Codebeispiel wird eine Miniaturansicht erstellt und angezeigt. Dieser Delegat wird nie aufgerufen.

public bool ThumbnailCallback()
 {
 return false;
 }
 public void Example_GetThumb(PaintEventArgs e)
 {
 Image.GetThumbnailImageAbort myCallback =
 new Image.GetThumbnailImageAbort(ThumbnailCallback);
 Bitmap myBitmap = new Bitmap("Climber.jpg");
 Image myThumbnail = myBitmap.GetThumbnailImage(
 40, 40, myCallback, IntPtr.Zero);
 e.Graphics.DrawImage(myThumbnail, 150, 75);
 }

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0
Anzeigen:
© 2014 Microsoft