Graphics.DrawImageAbort Délégué

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

Graphics.cs

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.

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

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

nativeint

Pointeur interne spécifiant les données pour la méthode de rappel. Toutes les surcharges DrawImage ne passent pas ce paramètre. Vous pouvez tester s'il existe en vérifiant la valeur 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. Sinon, elle retourne false pour indiquer que la méthode DrawImage doit poursuivre l'exécution.

Exemples

Cet exemple est une implémentation simpliste du Graphics.DrawImageAbort délégué. Il vérifie simplement si la DrawImage méthode lui a transmis des données à l’aide du paramètre callbackdata. (Certaines DrawImage surcharges ont uniquement un DrawImageAbort paramètre et ne passent aucune donnée ; certaines surcharges ont à la fois DrawImageAbort des paramètres et callbackdata et peuvent transmettre des données.) Si aucune donnée n’a été transmise, elle retourne true pour signaler à la méthode appelante DrawImage qu’elle doit annuler le dessin. Si des données ont été passées, elles indiquent false que le dessin doit continuer.

Une implémentation réaliste de ce rappel implique l’examen réel de certains critères pour annuler ou poursuivre l’exécution.

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 . Certaines surcharges de la DrawImage méthode appellent une méthode de rappel définie par l’application de ce type pour savoir si les surcharges doivent s’arrêter ou poursuivre l’exécution.

Pendant l’exécution, les surcharges pertinentes DrawImage appellent fréquemment cette méthode de rappel pour savoir si elles doivent arrêter de dessiner l’image spécifiée ou si elles doivent continuer à dessiner l’image. La Graphics.DrawImageAbort méthode de rappel peut déterminer s’il faut continuer ou non en fonction d’un algorithme choisi inclus dans celle-ci, éventuellement en utilisant les données qui lui sont transmises par le paramètre callbackdata. Par exemple, un algorithme peut déterminer si l’image a fait défiler l’écran et signaler une annulation à la méthode pour arrêter le DrawImage dessin.

Une déclaration utilisateur de cette méthode de gestion des événements doit avoir les mêmes paramètres que la déclaration de Graphics.DrawImageAbort délégué.

Méthodes d’extension