Image.GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) Método

Definição

Retorna uma miniatura para este Image.Returns a thumbnail for this 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.The width, in pixels, of the requested thumbnail image.

thumbHeight
Int32

A altura, em pixels, da imagem em miniatura solicitada.The height, in pixels, of the requested thumbnail image.

callback
Image.GetThumbnailImageAbort

Um delegado Image.GetThumbnailImageAbort.A Image.GetThumbnailImageAbort delegate.

Observação É preciso criar um delegado e passar uma referência para ele como o parâmetro callback, mas sem usar o delegado.Note You must create a delegate and pass a reference to the delegate as the callback parameter, but the delegate is not used.

callbackData
IntPtr

Deve ser Zero.Must be Zero.

Retornos

Um Image que representa a miniatura.An Image that represents the thumbnail.

Exemplos

O exemplo de código a seguir cria e exibe uma imagem em miniatura.The following code example creates and displays a thumbnail image. Esse delegado nunca é chamado.This delegate is never called.

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 em miniatura inserida, esse método recuperará a miniatura inserida e a dimensionará para o tamanho solicitado.If the Image contains an embedded thumbnail image, this method retrieves the embedded thumbnail and scales it to the requested size. Se o Image não contiver uma imagem em miniatura inserida, esse método criará uma imagem em miniatura ao dimensionar a imagem principal.If the Image does not contain an embedded thumbnail image, this method creates a thumbnail image by scaling the main image.

O método GetThumbnailImage funciona bem quando a imagem em miniatura solicitada tem um tamanho de cerca de 120 x 120 pixels.The GetThumbnailImage method works well when the requested thumbnail image has a size of about 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.If you request a large thumbnail image (for example, 300 x 300) from an Image that has an embedded thumbnail, there could be a noticeable loss of quality in the thumbnail image. Pode ser melhor dimensionar a imagem principal (em vez de dimensionar a miniatura inserida) chamando o método DrawImage.It might be better to scale the main image (instead of scaling the embedded thumbnail) by calling the DrawImage method.

Aplica-se a