Graphics.DrawImageAbort Délégué

Définition

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

[System.Runtime.InteropServices.ComVisible(false)]
public delegate bool Graphics.DrawImageAbort(IntPtr callbackdata);

public delegate bool Graphics.DrawImageAbort(IntPtr callbackdata);

[<System.Runtime.InteropServices.ComVisible(false)>]
type Graphics.DrawImageAbort = delegate of nativeint -> bool

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 si elle décide que la DrawImage méthode doit arrêter prématurément l’exécution. Sinon, elle retourne false pour indiquer que la DrawImage méthode doit continuer 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 l’a transmise à l’aide du paramètre callbackdata. (Certaines DrawImage surcharges n’ont qu’un DrawImageAbort paramètre et ne passent pas de données ; certaines surcharges ont à la fois DrawImageAbort des paramètres et callbackdata peuvent transmettre des données.) Si aucune donnée n’a été transmise, elle retourne true à la méthode appelante DrawImage qu’elle doit annuler le dessin. Si des données ont été passées, elle retourne false au signal 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 déterminer si les surcharges doivent 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 s’ils doivent arrêter de dessiner l’image spécifiée ou s’ils 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 celui-ci, éventuellement à l’aide des données 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 Graphics.DrawImageAbort déclaration de délégué.