Graphics.DrawImageAbort Délégué

Définition

Fournit une méthode de rappel pour déterminer à quel moment la méthode DrawImage doit prématurément annuler l'exécution et interrompre le dessin d'une image.Provides a callback method for deciding when the DrawImage method should prematurely cancel execution and stop drawing an image.

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
Public Delegate Function Graphics.DrawImageAbort(callbackdata As IntPtr) As Boolean 

Paramètres

callbackdata
IntPtr

Pointeur interne spécifiant les données pour la méthode de rappel.Internal pointer that specifies data for the callback method. Toutes les surcharges DrawImage ne passent pas ce paramètre.This parameter is not passed by all DrawImage overloads. Vous pouvez tester s'il existe en vérifiant la valeur Zero.You can test for its absence by checking for the value Zero.

Valeur renvoyée

Boolean

Cette méthode retourne true s'il est décidé que la méthode DrawImage doit prématurément arrêter l'exécution.This method returns true if it decides that the DrawImage method should prematurely stop execution. Sinon, elle retourne false pour indiquer que la méthode DrawImage doit poursuivre l'exécution.Otherwise it returns false to indicate that the DrawImage method should continue execution.

Héritage
Graphics.DrawImageAbort
Attributs

Exemples

Cet exemple est une implémentation simpliste du Graphics.DrawImageAbort délégué.This example is a simplistic implementation of the Graphics.DrawImageAbort delegate. Elle vérifie simplement si la méthode a DrawImage passé des données à l’aide du paramètre callbackdata.It merely checks to see if the DrawImage method has passed it data using the callbackdata parameter. (Certaines DrawImage surcharges ont uniquement un DrawImageAbort paramètre et ne passent aucune donnée; certaines surcharges ont à callbackdata la fois DrawImageAbort des paramètres et et peuvent passer des données.) Si aucune donnée n’a été passée, true elle retourne pour signaler à DrawImage la méthode appelante qu’elle doit annuler le dessin.(Some DrawImage overloads have only a DrawImageAbort parameter and pass no data; some overloads have both DrawImageAbort and callbackdata parameters and can pass data.) If no data was passed, it returns true to signal to the calling DrawImage method that it should cancel the drawing. Si des données ont été passées, false il retourne pour signaler que le dessin doit continuer.If data was passed, it returns false to signal that drawing should continue.

Une implémentation réaliste de ce rappel impliquerait l’examen réel de certains critères pour annuler ou poursuivre l’exécution.A realistic implementation of this callback would involve the actual scrutiny of some criteria to cancel or continue the execution.

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

Remarques

Cette méthode est utilisée conjointement avec la DrawImage méthode de la Graphics classe.This method is used in conjunction with the DrawImage method of the Graphics class. Certaines surcharges de la DrawImage méthode appellent une méthode de rappel définie par l’application de ce type pour déterminer si les surcharges doivent s’arrêter ou continuer l’exécution.Certain overloads of the DrawImage method call an application-defined callback method of this type to find out if the overloads should stop or continue execution.

Pendant l’exécution, les DrawImage surcharges appropriées appellent fréquemment cette méthode de rappel pour déterminer si elles doivent arrêter le dessin de l’image spécifiée ou si elles doivent continuer à dessiner l’image.During execution, the relevant DrawImage overloads frequently call this callback method to find out if they should stop drawing the specified image or if they should continue drawing the image. La Graphics.DrawImageAbort méthode de rappel peut déterminer s’il faut continuer ou non en fonction d’un algorithme choisi inclus, en utilisant éventuellement les données qui lui sont passées par le paramètre callbackdata.The Graphics.DrawImageAbort callback method can determine whether to continue or not based on a chosen algorithm included in it, optionally using the data passed to it by the callbackdata parameter. Par exemple, un algorithme peut déterminer si l’image a défilé à l’écran et signaler une annulation à la DrawImage méthode pour arrêter le dessin.For example, an algorithm might determine if the image has scrolled off the screen and signal a cancellation to the DrawImage method to stop drawing.

Une déclaration utilisateur de cette méthode de gestion d’événements doit avoir les mêmes paramètres que Graphics.DrawImageAbort la déclaration Delegate.A user declaration of this event-handling method must have the same parameters as the Graphics.DrawImageAbort delegate declaration.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.Gets an object that represents the method represented by the specified delegate.

S’applique à