Image.GetThumbnailImage-Methode
Gibt eine Miniaturansicht für dieses Image zurück.
Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)
Syntax
'Declaration
Public Function GetThumbnailImage ( _
thumbWidth As Integer, _
thumbHeight As Integer, _
callback As GetThumbnailImageAbort, _
callbackData As IntPtr _
) As Image
'Usage
Dim instance As Image
Dim thumbWidth As Integer
Dim thumbHeight As Integer
Dim callback As GetThumbnailImageAbort
Dim callbackData As IntPtr
Dim returnValue As Image
returnValue = instance.GetThumbnailImage(thumbWidth, thumbHeight, callback, callbackData)
public Image GetThumbnailImage (
int thumbWidth,
int thumbHeight,
GetThumbnailImageAbort callback,
IntPtr callbackData
)
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.
Hinweise
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.
Beispiel
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);
}
Plattformen
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.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0