Image.GetThumbnailImage Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

Image.cs

Retorna uma miniatura para este 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 em miniatura solicitada.

thumbHeight

Int32

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

callback

Image.GetThumbnailImageAbort

Um delegado Image.GetThumbnailImageAbort.

Observação É preciso criar um delegado e passar uma referência para ele como o parâmetro callback, mas sem usar o delegado.

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 o Image contiver uma imagem de miniatura inserida, esse método recuperará a miniatura inserida e a dimensiona para o tamanho solicitado. Se o Image não contiver uma imagem em miniatura inserida, esse método criará uma imagem em miniatura escalando a imagem main.

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 um Image que tenha uma miniatura inserida, poderá haver uma perda perceptível de qualidade na imagem em miniatura. Talvez seja melhor dimensionar a imagem main (em vez de dimensionar a miniatura inserida) chamando o DrawImage método .