Graphics.DrawImageAbort Delegat

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

Graphics.cs

Stellt eine Rückrufmethode bereit, mit der bestimmt wird, wann die DrawImage-Methode die Ausführung vorzeitig abbrechen und aufhören soll, ein Bild zu zeichnen.

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 

Parameter

callbackdata

IntPtr

nativeint

Interner Zeiger, der die Daten für die Rückrufmethode angibt. Dieser Parameter wird nicht von allen DrawImage-Überladungen übergeben. Sie können feststellen, dass dieser nicht vorhanden ist, wenn der Wert Zero ist.

Rückgabewert

Boolean

Diese Methode gibt true zurück, wenn die DrawImage-Methode die Ausführung vorzeitig abbrechen soll. Andernfalls wird false zurückgegeben, um anzugeben, dass die DrawImage-Methode die Ausführung fortsetzen soll.

Beispiele

Dieses Beispiel ist eine einfache Implementierung des Graphics.DrawImageAbort Delegaten. Sie überprüft lediglich, ob die DrawImage Methode daten übergeben hat, indem sie den Callbackdata-Parameter verwendet. (Einige DrawImage Überladungen verfügen nur über einen DrawImageAbort Parameter und übergeben keine Daten. Einige Überladungen verfügen über parameter DrawImageAbort und callbackdata können Daten übergeben.) Wenn keine Daten übergeben wurden, wird true zurückgegeben, um der aufrufenden DrawImage Methode zu signalisieren, dass die Zeichnung abgebrochen werden soll. Wenn Daten übergeben wurden, wird zurückgegeben false , um zu signalisieren, dass die Zeichnung fortgesetzt werden soll.

Eine realistische Implementierung dieses Rückrufs würde die tatsächliche Überprüfung einiger Kriterien erfordern, um die Ausführung abzubrechen oder fortzusetzen.

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

Hinweise

Diese Methode wird in Verbindung mit der DrawImage -Methode der Graphics -Klasse verwendet. Bestimmte Überladungen der DrawImage Methode rufen eine anwendungsdefinierte Rückrufmethode dieses Typs auf, um herauszufinden, ob die Überladungen die Ausführung beenden oder fortsetzen sollen.

Während der Ausführung rufen die relevanten DrawImage Überladungen häufig diese Rückrufmethode auf, um herauszufinden, ob das Zeichnen des angegebenen Bilds beendet oder das Zeichnen des Bilds fortgesetzt werden soll. Die Graphics.DrawImageAbort Rückrufmethode kann basierend auf einem ausgewählten Algorithmus, der darin enthalten ist, festlegen, ob sie fortgesetzt wird oder nicht, optional mithilfe der Daten, die vom callbackdata-Parameter an sie übergeben werden. Ein Algorithmus kann z. B. ermitteln, ob das Bild vom Bildschirm gescrollt wurde, und der Methode eine Abbruchmeldung signalisieren, um das DrawImage Zeichnen zu beenden.

Eine Benutzerdeklaration dieser Ereignisbehandlungsmethode muss dieselben Parameter wie die Graphics.DrawImageAbort Delegatdeklaration aufweisen.

Erweiterungsmethoden