Graphics.DrawImageAbort Délégué

Définition

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 

Paramètres

Valeur renvoyée

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.

Attributs

ComVisibleAttribute

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

S’applique à