Image.GetThumbnailImage Método

Definição

Namespace:
System.Drawing
Assembly:
System.Drawing.dll

Retorna uma miniatura para isso 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

Parâmetros

thumbWidth
Int32

A largura, em pixels, da imagem de miniatura solicitada.

thumbHeight
Int32

A altura, em pixels, da imagem de miniatura solicitada.

callback
Image.GetThumbnailImageAbort

Um Image.GetThumbnailImageAbort delegado.

Nota Você deve criar um delegado e passar uma referência ao delegado como o callback parâmetro, mas o delegado não é usado.

callbackData
IntPtr

nativeint

Deve ser Zero.

Retornos

Image

Um Image que representa a miniatura.

Exemplos

O exemplo de código a seguir cria e exibe uma imagem em miniatura. Esse delegado nunca é chamado.

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

Comentários

Se a Image imagem contiver uma miniatura inserida, esse método recuperará a miniatura inserida e a dimensiona para o tamanho solicitado. Se não Image contiver uma imagem em miniatura inserida, esse método criará uma imagem em miniatura dimensionando a imagem principal.

O GetThumbnailImage método funciona bem quando a imagem de miniatura solicitada tem um tamanho de cerca de 120 x 120 pixels. Se você solicitar uma imagem em miniatura grande (por exemplo, 300 x 300) de uma Image miniatura inserida, poderá haver uma perda notável de qualidade na imagem em miniatura. Talvez seja melhor dimensionar a imagem principal (em vez de dimensionar a miniatura inserida) chamando o DrawImage método.

Aplica-se a