Image.GetThumbnailImage Methode

public:
 System::Drawing::Image ^ GetThumbnailImage(int thumbWidth, int thumbHeight, System::Drawing::Image::GetThumbnailImageAbort ^ callback, IntPtr callbackData);

public System.Drawing.Image GetThumbnailImage (int thumbWidth, int thumbHeight, System.Drawing.Image.GetThumbnailImageAbort callback, IntPtr callbackData);

public System.Drawing.Image GetThumbnailImage (int thumbWidth, int thumbHeight, System.Drawing.Image.GetThumbnailImageAbort? callback, IntPtr callbackData);

member this.GetThumbnailImage : int * int * System.Drawing.Image.GetThumbnailImageAbort * nativeint -> System.Drawing.Image

Public Function GetThumbnailImage (thumbWidth As Integer, thumbHeight As Integer, callback As Image.GetThumbnailImageAbort, callbackData As IntPtr) As Image

Parameter

Gibt zurück

Ein Image, das die Miniaturansicht darstellt.

Beispiele

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);
}

Public Function ThumbnailCallback() As Boolean 
  Return False 
End Function 

Public Sub Example_GetThumb(ByVal e As PaintEventArgs) 
    Dim myCallback As New Image.GetThumbnailImageAbort(AddressOf ThumbnailCallback) 
    Dim myBitmap As New Bitmap("Climber.jpg") 
    Dim myThumbnail As Image = myBitmap.GetThumbnailImage(40, 40, myCallback, IntPtr.Zero) 
    e.Graphics.DrawImage(myThumbnail, 150, 75) 
End Sub

Hinweise

Wenn die Image ein eingebettetes Miniaturbild 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, indem das Standard Bild skaliert wird.

Die GetThumbnailImage Methode funktioniert gut, wenn das angeforderte Miniaturansichtsbild eine Größe von etwa 120 x 120 Pixel aufweist. Wenn Sie ein großes Miniaturbild (z. B. 300 x 300) von einem Image anfordern, das eine eingebettete Miniaturansicht aufweist, kann es zu einem spürbaren Qualitätsverlust im Miniaturbild kommen. Es ist möglicherweise besser, das Standard Bild zu skalieren (anstatt die eingebettete Miniaturansicht zu skalieren), indem Sie die DrawImage -Methode aufrufen.

Gilt für: