Image.GetThumbnailImage Méthode

Définition

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

S’applique à