Image.GetThumbnailImage 方法

定義

傳回這個 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);

參數

thumbWidth
Int32

要求的縮圖影像的寬度 (單位為像素)。

thumbHeight
Int32

要求的縮圖影像的高度 (單位為像素)。

callback
Image.GetThumbnailImageAbort

Image.GetThumbnailImageAbort 委派 (Delegate)。

注意:您必須建立委派,並將委派的參考當作 callback 參數傳遞,而不使用該委派。

callbackData
IntPtr

必須是 Zero

傳回

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

備註

Image如果 包含內嵌縮圖影像,這個方法會擷取內嵌縮圖,並將它調整為所要求的大小。 Image如果 不包含內嵌縮圖影像,此方法會藉由調整主要影像來建立縮圖影像。

當要求的縮圖影像大小大約為 120 x 120 像素時,此方法 GetThumbnailImage 可正常運作。 例如,如果您從具有內嵌縮圖的 要求大型縮圖影像 (300 x 300) Image ,縮圖影像中可能會有明顯的質量遺失。 最好是藉由呼叫 DrawImage 方法來調整主要影像 (,而不是調整內嵌縮圖) 。

適用於

產品 版本
.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