Image.GetThumbnailImage Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

Image.cs

Retourne la miniature de ce Image.

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

Paramètres

thumbWidth

Int32

Largeur, en pixels, de l'image miniature demandée.

thumbHeight

Int32

Hauteur, en pixels, de l'image miniature demandée.

callback

Image.GetThumbnailImageAbort

Délégué Image.GetThumbnailImageAbort.

Remarque Vous devez créer un délégué et passer une référence au délégué comme paramètre callback, toutefois, le délégué n’est pas utilisé.

callbackData

IntPtr

nativeint

Doit être Zero.

Retours

Image

Image qui représente la miniature.

Exemples

L’exemple de code suivant crée et affiche une image miniature. Ce délégué n’est jamais appelé.

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

Remarques

Si contient Image une image miniature incorporée, cette méthode récupère la miniature incorporée et la met à l’échelle à la taille demandée. Si ne contient pas d’image miniature incorporée, cette méthode crée une image miniature en mettant à l’échelle Image l’image main.

La GetThumbnailImage méthode fonctionne bien lorsque l’image miniature demandée a une taille d’environ 120 x 120 pixels. Si vous demandez une image miniature volumineuse (par exemple, 300 x 300) à partir d’un Image qui a une miniature incorporée, il peut y avoir une perte de qualité notable dans l’image miniature. Il peut être préférable de mettre à l’échelle l’image main (au lieu de mettre à l’échelle la miniature incorporée) en appelant la DrawImage méthode .