Graphics.DrawImageAbort Delegat
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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:
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Feedback senden und anzeigen für