Image.GetThumbnailImage Metoda

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v8.0.0

Zdroj:

Image.cs

Vrátí miniaturu pro tento 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

Šířka požadovaného obrázku miniatury (v pixelech).

thumbHeight

Int32

Výška požadovaného obrázku miniatury (v pixelech).

callback

Image.GetThumbnailImageAbort

Delegát.Image.GetThumbnailImageAbort

Poznámka Musíte vytvořit delegáta a předat ho jako callback parametr odkaz, ale delegát se nepoužije.

callbackData

IntPtr

nativeint

Musí být Zero.

Návraty

Image

Představuje Image miniaturu.

Příklady

Následující příklad kódu vytvoří a zobrazí miniaturu. Tento delegát se nikdy nevolá.

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

Poznámky

Image Pokud objekt obsahuje vložený obrázek miniatury, tato metoda načte vloženou miniaturu a zvětšuje ji na požadovanou velikost. Image Pokud objekt neobsahuje vložený obrázek miniatury, tato metoda vytvoří miniaturu pomocí měřítka hlavního obrázku.

Metoda GetThumbnailImage funguje dobře, když má požadovaný miniatura velikost přibližně 120 x 120 pixelů. Pokud požádáte o velký obrázek miniatury (například 300 × 300) z Image objektu, který obsahuje vloženou miniaturu, může dojít ke znatelné ztrátě kvality miniatury. Možná bude lepší změnit měřítko hlavního obrázku (místo změny velikosti vložené miniatury) voláním DrawImage metody .