Graphics.DrawImageAbort Delegat

Definition

public: delegate bool Graphics::DrawImageAbort(IntPtr callbackdata);

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

public delegate bool Graphics.DrawImageAbort(IntPtr callbackdata);

[<System.Runtime.InteropServices.ComVisible(false)>]
type Graphics.DrawImageAbort = delegate of nativeint -> bool

type Graphics.DrawImageAbort = delegate of nativeint -> bool

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

Parameter

Rückgabewert

Diese Methode gibt zurück, wenn sie entscheidet true , dass die Methode vorzeitig die DrawImage Ausführung beenden soll. Andernfalls wird false angegeben, dass die DrawImage Methode die Ausführung fortsetzen soll.

Attribute

ComVisibleAttribute

Beispiele

Dieses Beispiel ist eine vereinfachte Implementierung des Graphics.DrawImageAbort Delegaten. Es überprüft lediglich, ob die DrawImage Methode die Daten mithilfe des Rückrufdatenparameters übergeben hat. (Einige DrawImage Überladungen weisen nur einen DrawImageAbort Parameter auf und übergeben keine Daten. Einige Überladungen weisen sowohl parameter als callbackdata auch DrawImageAbort Parameter auf und können Daten übergeben.) Wenn keine Daten übergeben wurden, wird sie an true die aufrufende DrawImage Methode zurückgegeben, dass die Zeichnung abgebrochen werden soll. Wenn Daten übergeben wurden, wird sie zurückgegeben false , um zu signalisieren, dass die Zeichnung fortgesetzt werden soll.

Eine realistische Implementierung dieses Rückrufs würde die tatsächliche Prüfung einiger Kriterien umfassen, 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 beendet oder die Ausführung fortsetzen sollen.

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 bestimmen, ob die Fortsetzung oder nicht basierend auf einem ausgewählten Algorithmus, der darin enthalten ist, optional mithilfe der daten verwendet werden, die vom Parameter "callbackdata" an sie übergeben werden. Beispielsweise kann ein Algorithmus bestimmen, ob das Bild vom Bildschirm gescrollt wurde, und signalisieren einen Abbruch an die Methode, um die DrawImage Zeichnung zu beenden.

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