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