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.

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

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

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

Exemples

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

Une implémentation réaliste de ce rappel impliquerait 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 arrêter ou continuer l’exécution.

Pendant l’exécution, les surcharges appropriées DrawImage appellent fréquemment cette méthode de rappel pour savoir si elles doivent arrêter le dessin de 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 elle, en utilisant éventuellement 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

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.

S’applique à