Graphics.DrawImageAbort Delegato

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

Graphics.cs

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

public delegate bool Graphics.DrawImageAbort(IntPtr callbackdata);

type Graphics.DrawImageAbort = delegate of nativeint -> bool

Public Delegate Function Graphics.DrawImageAbort(callbackdata As IntPtr) As Boolean 

Parametri

callbackdata

IntPtr

nativeint

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

Boolean

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.

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.

Private Function DrawImageCallback(callBackData As IntPtr) As Boolean  
     ' Test for call that passes callBackData parameter.  
     If callBackData.Equals(IntPtr.Zero) Then  
         ' If no callBackData passed, abort DrawImage method.  
         Return True  
     Else  
         ' If callBackData passed, continue DrawImage method.  
         Return False  
     End If  
 End Function 'DrawImageCallback  

// 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