Image.GetThumbnailImage 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

Source:

Image.cs

返回此 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

参数

thumbWidth

Int32

请求的缩略图的宽度（以像素为单位）。

thumbHeight

Int32

请求的缩略图的高度（以像素为单位）。

callback

Image.GetThumbnailImageAbort

一个 Image.GetThumbnailImageAbort 委托。

注意，必须创建一个委托并将对此委托的引用作为 callback 参数传递，但此委托不会被使用。

callbackData

IntPtr

nativeint

必须是 Zero。

返回

Image

表示缩略图的 Image。

示例

下面的代码示例创建并显示缩略图。 永远不会调用此委托。

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

注解

Image如果 包含嵌入的缩略图图像，此方法将检索嵌入的缩略图，并将其缩放为请求的大小。 Image如果 不包含嵌入的缩略图图像，则此方法通过缩放main图像来创建缩略图。

GetThumbnailImage当请求的缩略图图像的大小约为 120 x 120 像素时，方法非常有效。 例如，如果请求大缩略图图像 (300 x 300) Image ，则缩略图图像的质量可能会明显下降。 最好 (缩放main图像，而不是通过调用 DrawImage 方法缩放嵌入的缩略图) 。