Image.GetThumbnailImage 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

來源:

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 委派 (Delegate)。

注意：您必須建立委派，並將委派的參考當作 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如果 不包含內嵌縮圖影像，此方法會藉由調整主要影像來建立縮圖影像。

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