Graphics.DrawImageAbort-Delegat
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.
Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)
Syntax
'Declaration
Public Delegate Function DrawImageAbort ( _
callbackdata As IntPtr _
) As Boolean
'Usage
Dim instance As New DrawImageAbort(AddressOf HandlerMethod)
public delegate bool DrawImageAbort (
IntPtr callbackdata
)
public delegate bool DrawImageAbort (
IntPtr callbackdata
)
/** @delegate */
public delegate boolean DrawImageAbort (
IntPtr callbackdata
)
JScript unterstützt die Verwendung von Delegaten, aber nicht die Deklaration von neuen Delegaten.
Parameter
- callbackdata
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.
Hinweise
Diese Methode wird zusammen mit der DrawImage-Methode der Graphics-Klasse verwendet. Bestimmte Überladungen der DrawImage-Methode rufen eine von der Anwendung definierte Rückrufmethode dieses Typs auf, um zu ermitteln, ob die Überladungen die Anwendung beenden oder fortsetzen soll.
Während der Ausführung rufen die betreffenden DrawImage-Überladungen häufig diese Rückrufmethode auf, um festzustellen, ob sie das Zeichnen des Bildes fortsetzen oder beenden sollen. Die Graphics.DrawImageAbort-Rückrufmethode kann mithilfe eines ausgewählten integrierten Algorithmus ermitteln, ob sie fortfahren soll. Dabei können bei Bedarf die vom callbackdata-Parameter übergebenen Daten verwendet werden. Ein Algorithmus kann z. B. bestimmen, dass das Bild sich durch einen Bildlauf nicht mehr auf dem Bildschirm befindet, und der DrawImage-Methode signalisieren, dass sie das Zeichnen beenden soll.
Eine Benutzerdeklaration dieser Ereignisbehandlungsmethode muss dieselben Parameter aufweisen wie die Deklaration des Graphics.DrawImageAbort-Delegaten.
Beispiel
Dieses Beispiel ist eine vereinfachte Implementierung des Graphics.DrawImageAbort-Delegaten. Es wird nur überprüft, ob die DrawImage-Methode Daten mit dem callbackdata-Parameter übergeben hat. (Einige DrawImage-Überladungen haben nur einen DrawImageAbort-Parameter und übergeben keine Daten. Andere Überladungen haben sowohl DrawImageAbort-Parameter als auch callbackdata-Parameter und können Daten übergeben.) Wenn keine Daten übergeben wurden, wird true zurückgegeben, um der aufrufenden DrawImage-Methode zu signalisieren, dass das Zeichnen abgebrochen werden soll. Wenn Daten übergeben wurden, wird false zurückgeben und damit signalisiert, das das Zeichnen fortgesetzt werden soll.
Eine realistische Implementierung dieses Rückrufs enthält z. B. die Überprüfung einiger Kriterien dazu, ob die Ausführung fortgesetzt oder beendet werden soll.
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;
}
}
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0