Image.GetThumbnailImage Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Source:

Image.cs

Restituisce un'anteprima di questo oggetto 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

Parametri

thumbWidth

Int32

Larghezza in pixel dell'immagine di anteprima richiesta.

thumbHeight

Int32

Altezza in pixel dell'immagine di anteprima richiesta.

callback

Image.GetThumbnailImageAbort

Delegato di Image.GetThumbnailImageAbort.

Nota È necessario creare un delegato e passare un riferimento al delegato come parametro callback, ma il delegato non viene usato.

callbackData

IntPtr

nativeint

Deve essere Zero.

Restituisce

Image

Oggetto Image che rappresenta l'anteprima.

Esempio

Nell'esempio di codice seguente viene creata e visualizzata un'immagine di anteprima. Questo delegato non viene mai chiamato.

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

Commenti

Se contiene Image un'immagine di anteprima incorporata, questo metodo recupera l'anteprima incorporata e lo ridimensiona alla dimensione richiesta. Se non Image contiene un'immagine di anteprima incorporata, questo metodo crea un'immagine di anteprima ridimensionando l'immagine principale.

Il GetThumbnailImage metodo funziona bene quando l'immagine di anteprima richiesta ha una dimensione di circa 120 x 120 pixel. Se si richiede un'immagine di anteprima di grandi dimensioni (ad esempio, 300 x 300) da un Image oggetto che ha un'anteprima incorporata, potrebbe verificarsi una perdita evidente di qualità nell'immagine di anteprima. Potrebbe essere preferibile ridimensionare l'immagine principale (anziché ridimensionare l'anteprima incorporata) chiamando il DrawImage metodo .