Graphics.DrawImageAbort Delegato

Definizione

Fornisce un metodo di callback per decidere quando il metodo DrawImage deve annullare l'esecuzione e interrompere il disegno di un'immagine.

public delegate bool Graphics.DrawImageAbort(IntPtr callbackdata);
[System.Runtime.InteropServices.ComVisible(false)]
public delegate bool Graphics.DrawImageAbort(IntPtr callbackdata);

Parametri

callbackdata
IntPtr

Puntatore interno che specifica i dati per il metodo di callback. Questo parametro non viene passato da tutti gli overload di DrawImage. È possibile verificare la sua assenza controllando il valore Zero.

Valore restituito

Questo metodo restituisce true se decide che il metodo DrawImage deve interrompere l'esecuzione. In caso contrario, restituisce false, per indicare che il metodo DrawImage deve continuare l'esecuzione.

Attributi

Esempio

Questo esempio è un'implementazione semplicistica del Graphics.DrawImageAbort delegato. Verifica semplicemente se il metodo ha passato i DrawImage dati usando il parametro callbackdata. Alcuni overload hanno solo un DrawImageAbort parametro e non passano dati. Alcuni DrawImage overload hanno entrambi DrawImageAbort i parametri e callbackdata e possono passare dati. Se non sono stati passati dati, restituisce true un segnale al metodo chiamante DrawImage che deve annullare il disegno. Se i dati sono stati passati, restituisce false un segnale che il disegno deve continuare.

Un'implementazione realistica di questo callback implica l'effettiva verifica di alcuni criteri per annullare o continuare l'esecuzione.

// Define DrawImageAbort callback method.  
 private bool DrawImageCallback(IntPtr callbackdata)  
 {  
    // Test for call that passes callBackData parameter.  
    if(callbackdata==IntPtr.Zero)  
    {  
       // If no callbackdata passed, cancel DrawImage method.  
       return true;  
    }  
    else  
    {  
       // If callbackdata passed, continue DrawImage method.  
       return false;  
    }  
 }  

Commenti

Questo metodo viene usato insieme al DrawImage metodo della Graphics classe . Alcuni overload del DrawImage metodo chiamano un metodo di callback definito dall'applicazione di questo tipo per scoprire se gli overload devono arrestare o continuare l'esecuzione.

Durante l'esecuzione, gli overload pertinenti DrawImage chiamano spesso questo metodo di callback per scoprire se devono interrompere il disegno dell'immagine specificata o se devono continuare a disegnare l'immagine. Il Graphics.DrawImageAbort metodo di callback può determinare se continuare o meno in base a un algoritmo scelto incluso, facoltativamente usando i dati passati dal parametro callbackdata. Ad esempio, un algoritmo potrebbe determinare se l'immagine è stata scorrere dallo schermo e segnalare un annullamento al metodo per interrompere il DrawImage disegno.

Una dichiarazione utente di questo metodo di gestione degli eventi deve avere gli stessi parametri della dichiarazione del Graphics.DrawImageAbort delegato.

Metodi di estensione

GetMethodInfo(Delegate)

Ottiene un oggetto che rappresenta il metodo rappresentato dal delegato specificato.

Si applica a

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9