Image.GetThumbnailImage Metoda

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v11.0.0-preview.5.26302.115

Zdroj:

Image.cs

Vrátí miniaturu pro toto 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 odkaz na delegáta callback jako parametr, ale delegát se nepoužívá.

callbackData

IntPtr

nativeint

Musí být Zero.

Návraty

Image

Jedná se o Image miniaturu.

Příklady

Následující příklad kódu vytvoří a zobrazí miniaturu obrázku. 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 obsahuje vložený miniaturu, tato metoda načte vloženou miniaturu a škáluje ji na požadovanou velikost. Pokud vložený miniatura Image neobsahuje, tato metoda vytvoří miniaturu tím, že zvětšuje hlavní obrázek.

Metoda GetThumbnailImage funguje dobře, když požadovaný obrázek miniatury má velikost asi 120 x 120 pixelů. Pokud požádáte o velký miniaturový obrázek (například 300 × 300) z Image vložené miniatury, může dojít ke znatelné ztrátě kvality na obrázku miniatury. Možná bude lepší škálovat hlavní obrázek (místo škálování vložené miniatury) voláním DrawImage metody.