Image.GetThumbnailImage Méthode

Définition

Espace de noms:
System.Drawing
Assembly:
System.Drawing.dll

Retourne une miniature pour 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 .

Note Vous devez créer un délégué et transmettre une référence au délégué en tant que callback paramètre, mais le délégué n’est pas utilisé.

callbackData
IntPtr

nativeint

Doit être Zero.

Retours

Image

Représentant Image 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 elle Image contient 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 elle ne contient pas d’image miniature incorporée, cette méthode crée une image miniature en mettant à l’échelle Image l’image principale.

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’une Image miniature incorporée, il peut y avoir une perte notable de qualité dans l’image miniature. Il peut être préférable de mettre à l’échelle l’image principale (au lieu de mettre à l’échelle la miniature incorporée) en appelant la DrawImage méthode.

S’applique à