Graphics.DrawImageAbort Delegat

Definition

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);
[System.Runtime.InteropServices.ComVisible(false)]
public delegate bool Graphics.DrawImageAbort(IntPtr callbackdata);
type Graphics.DrawImageAbort = delegate of nativeint -> bool
[<System.Runtime.InteropServices.ComVisible(false)>]
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

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.

Attribute

Beispiele

Dieses Beispiel ist eine einfache Implementierung des Graphics.DrawImageAbort Delegaten. Mit dem Parameter callbackdata wird lediglich überprüft, ob die DrawImage -Methode die Daten übergeben hat. (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 zurückgegeben true , 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 das Zeichnen 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 Ausführung der Überladungen beendet oder fortgesetzt werden soll.

Während der Ausführung rufen die relevanten DrawImage Überladungen diese Rückrufmethode häufig auf, um herauszufinden, ob sie das Zeichnen des angegebenen Bilds beenden oder das Zeichnen des Bilds fortsetzen sollen. Die Graphics.DrawImageAbort Rückrufmethode kann basierend auf einem ausgewählten Algorithmus, der darin enthalten ist, bestimmen, ob fortgesetzt werden soll oder nicht, indem optional die Daten verwendet werden, die vom callbackdata-Parameter an sie übergeben werden. Beispielsweise kann ein Algorithmus ermitteln, ob das Bild vom Bildschirm gescrollt wurde, und der Methode einen Abbruch signalisieren, um das DrawImage Zeichnen zu beenden.

Eine Benutzerdeklaration dieser Ereignisbehandlungsmethode muss über die gleichen Parameter wie die Graphics.DrawImageAbort Delegatdeklaration verfügen.

Erweiterungsmethoden

GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.

Gilt für: