Image.GetThumbnailImage 方法

返回此 Image 的缩略图。

**命名空间:**System.Drawing
**程序集:**System.Drawing(在 system.drawing.dll 中)

语法

声明
Public Function GetThumbnailImage ( _
    thumbWidth As Integer, _
    thumbHeight As Integer, _
    callback As GetThumbnailImageAbort, _
    callbackData As IntPtr _
) As Image
用法
Dim instance As Image
Dim thumbWidth As Integer
Dim thumbHeight As Integer
Dim callback As GetThumbnailImageAbort
Dim callbackData As IntPtr
Dim returnValue As Image

returnValue = instance.GetThumbnailImage(thumbWidth, thumbHeight, callback, callbackData)
public Image GetThumbnailImage (
    int thumbWidth,
    int thumbHeight,
    GetThumbnailImageAbort callback,
    IntPtr callbackData
)
public:
Image^ GetThumbnailImage (
    int thumbWidth, 
    int thumbHeight, 
    GetThumbnailImageAbort^ callback, 
    IntPtr callbackData
)
public Image GetThumbnailImage (
    int thumbWidth, 
    int thumbHeight, 
    GetThumbnailImageAbort callback, 
    IntPtr callbackData
)
public function GetThumbnailImage (
    thumbWidth : int, 
    thumbHeight : int, 
    callback : GetThumbnailImageAbort, 
    callbackData : IntPtr
) : Image

参数

  • thumbWidth
    请求的缩略图的宽度(以像素为单位)。
  • thumbHeight
    请求的缩略图的高度(以像素为单位)。
  • callback
    一个 Image.GetThumbnailImageAbort 委托。在 GDI+ 1.0 版中不使用此委托。即便如此,也必须创建一个委托并在该参数中传递对此委托的引用。
  • callbackData
    必须为 Zero

返回值

表示缩略图的 Image

备注

如果 Image 包含一个嵌入式缩略图像,则此方法会检索嵌入式缩略图,并将其缩放为所需大小。如果 Image 不包含嵌入式缩略图像,此方法会通过缩放主图像创建一个缩略图像。

请求的缩略图像大小为 120 x 120 像素时,GetThumbnailImage 方法正常运行。如果从具有嵌入式缩略图的 Image 处请求较大的缩略图像(例如,300 x 300),则缩略图像的质量可能显著降低。通过调用 DrawImage 方法缩放主图像(而非嵌入式缩略图),则效果可能较好。

示例

下面的代码示例创建并显示一个缩略图像。从不调用此委托。

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

平台

Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

请参见

参考

Image 类
Image 成员
System.Drawing 命名空间