Image.GetThumbnailImage Método

Definición

Espacio de nombres:
System.Drawing
Ensamblado:
System.Drawing.dll

Devuelve una miniatura para este Imageobjeto .

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

Ancho, en píxeles, de la imagen en miniatura solicitada.

thumbHeight
Int32

Alto, en píxeles, de la imagen en miniatura solicitada.

callback
Image.GetThumbnailImageAbort

Delegado Image.GetThumbnailImageAbort .

Nota Debe crear un delegado y pasar una referencia al delegado como callback parámetro, pero no se usa el delegado.

callbackData
IntPtr

nativeint

Debe ser Zero.

Devoluciones

Image

que Image representa la miniatura.

Ejemplos

En el ejemplo de código siguiente se crea y se muestra una imagen en miniatura. Nunca se llama a este delegado.

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

Comentarios

Image Si contiene una imagen en miniatura incrustada, este método recupera la miniatura incrustada y la escala al tamaño solicitado. Si no Image contiene una imagen en miniatura incrustada, este método crea una imagen en miniatura mediante el escalado de la imagen principal.

El GetThumbnailImage método funciona bien cuando la imagen en miniatura solicitada tiene un tamaño de aproximadamente 120 x 120 píxeles. Si solicita una imagen en miniatura grande (por ejemplo, 300 x 300) desde un Image que tiene una miniatura incrustada, podría haber una pérdida notable de calidad en la imagen en miniatura. Es posible que sea mejor escalar la imagen principal (en lugar de escalar la miniatura incrustada) llamando al DrawImage método .

Se aplica a