Image.GetThumbnailImage Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

Image.cs

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

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

thumbWidth

Int32

Die Breite der angeforderten Miniaturansicht in Pixel.

thumbHeight

Int32

Die Höhe der angeforderten Miniaturansicht in Pixel.

callback

Image.GetThumbnailImageAbort

Ein Image.GetThumbnailImageAbort-Delegat.

Hinweis: Sie müssen einen Delegaten erstellen und einen Verweis auf den Delegaten als callback-Parameter übergeben. Der Delegat wird jedoch nicht verwendet.

callbackData

IntPtr

nativeint

Muss Zerolauten.

Gibt zurück

Image

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.