Image.GetThumbnailImage Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Source:

Image.cs

Devuelve una miniatura de 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

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 pasarle una referencia como el parámetro callback, pero no se usa el delegado.

callbackData

IntPtr

nativeint

Debe ser Zero.

Devoluciones

Image

Image que 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. Image Si no 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) de un Image que tiene una miniatura incrustada, podría haber una pérdida notable de calidad en la imagen en miniatura. Puede ser mejor escalar la imagen principal (en lugar de escalar la miniatura incrustada) llamando al DrawImage método .