Metodo Image.GetThumbnailImage (System.Drawing)

Cambia visualizzazione:
ScriptFree
Riferimento a .NET Framework
Metodo Image.GetThumbnailImage
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Restituisce un'anteprima di questo oggetto Image.

Spazio dei nomi:  System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)
Sintassi

Visual Basic
Public Function GetThumbnailImage ( _
	thumbWidth As Integer, _
	thumbHeight As Integer, _
	callback As Image..::..GetThumbnailImageAbort, _
	callbackData As IntPtr _
) As Image
C#
public Image GetThumbnailImage(
	int thumbWidth,
	int thumbHeight,
	Image..::..GetThumbnailImageAbort callback,
	IntPtr callbackData
)
Visual C++
public:
Image^ GetThumbnailImage(
	int thumbWidth, 
	int thumbHeight, 
	Image..::..GetThumbnailImageAbort^ callback, 
	IntPtr callbackData
)
F#
member GetThumbnailImage : 
        thumbWidth:int * 
        thumbHeight:int * 
        callback:Image..::..GetThumbnailImageAbort * 
        callbackData:IntPtr -> Image 

Parametri

thumbWidth
Tipo: System.Int32
Larghezza in pixel dell'immagine di anteprima richiesta.
thumbHeight
Tipo: System.Int32
Altezza in pixel dell'immagine di anteprima richiesta.
callback
Tipo: System.Drawing.Image.GetThumbnailImageAbort
Delegato Image.GetThumbnailImageAbort.
Nota   È necessario creare un delegato e passare un riferimento al delegato come parametro callback, ma il delegato non viene utilizzato.
callbackData
Tipo: System.IntPtr
Deve essere Zero.

Valore restituito

Tipo: System.Drawing.Image
Oggetto Image che rappresenta l'anteprima.
Note

Se l'oggetto Image contiene un'immagine di anteprima incorporata, questo metodo consentirà di recuperare l'anteprima incorporata e di ottenere le dimensioni richieste. Se l'oggetto Image non contiene un'immagine di anteprima incorporata, questo metodo consentirà di creare un'immagine di anteprima ridimensionando le proporzioni dell'immagine principale.

Il metodo GetThumbnailImage garantisce migliori risultati quando le dimensioni dell'immagine di anteprima richiesta sono pari a circa 120x120 pixel. Se si richiede un'immagine di anteprima di grandi dimensioni, ad esempio 300x300, da un oggetto Image che dispone di un'anteprima incorporata, è possibile che si verifichi una notevole perdita di qualità dell'immagine dell'anteprima. Potrebbe essere consigliabile ridimensionare l'immagine principale, anziché ridimensionare l'anteprima incorporata, chiamando il metodo DrawImage .

Esempi

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

Visual Basic


    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 



C#

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);
}


Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Vedere anche

Riferimenti