Image.GetThumbnailImage Método

Referencia

Definición

Espacio de nombres:: System.Drawing

Ensamblado:: System.Drawing.Common.dll

Ensamblado:: System.Drawing.dll

Paquete:: System.Drawing.Common v6.0.0

Paquete:: System.Drawing.Common v7.0.0

Paquete:: System.Drawing.Common v8.0.0

Paquete:: System.Drawing.Common v9.0.0-preview.2.24128.3

Source:: Image.cs

Source:: Image.cs

Source:: Image.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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);

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

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 .

Se aplica a

Producto	Versiones
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Compartir a través de