Image.GetThumbnailImage Metoda

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

Image.cs

Zwraca miniaturę dla tego .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

Parametry

thumbWidth

Int32

Szerokość żądanego obrazu miniatury w pikselach.

thumbHeight

Int32

Wysokość w pikselach żądanego obrazu miniatury.

callback

Image.GetThumbnailImageAbort

Delegat Image.GetThumbnailImageAbort .

Uwaga Należy utworzyć delegata i przekazać odwołanie do delegata callback jako parametr, ale delegat nie jest używany.

callbackData

IntPtr

nativeint

Musi mieć wartość Zero.

Zwraca

Image

Obiekt Image reprezentujący miniaturę.

Przykłady

Poniższy przykład kodu tworzy i wyświetla obraz miniatury. Ten delegat nigdy nie jest wywoływany.

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

Uwagi

Jeśli obiekt Image zawiera osadzony obraz miniatury, ta metoda pobiera osadzoną miniaturę i skaluje ją do żądanego rozmiaru. Jeśli obiekt Image nie zawiera osadzonego obrazu miniatury, ta metoda tworzy obraz miniatury, skalując obraz główny.

Metoda GetThumbnailImage działa dobrze, gdy żądany obraz miniatury ma rozmiar około 120 x 120 pikseli. Jeśli zażądasz dużego obrazu miniatury (na przykład 300 x 300) z Image osadzonej miniatury, może to spowodować zauważalną utratę jakości obrazu miniatury. Lepszym rozwiązaniem może być skalowanie obrazu głównego (zamiast skalowania osadzonej miniatury) przez wywołanie DrawImage metody .