Graphics.DrawImageAbort Gedelegeerde

Definitie

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 

Parameters

Retourwaarde

Deze methode retourneert true als deze besluit dat de DrawImage methode voortijdig de uitvoering moet stoppen. Anders wordt geretourneerd false om aan te geven dat de DrawImage methode moet doorgaan met de uitvoering.

Kenmerken

ComVisibleAttribute

Voorbeelden

Dit voorbeeld is een simplistische implementatie van de Graphics.DrawImageAbort gemachtigde. Er wordt alleen gecontroleerd of de DrawImage methode deze gegevens heeft doorgegeven met behulp van de parameter callbackdata. (Sommige DrawImage overbelastingen hebben slechts een DrawImageAbort parameter en geven geen gegevens door; sommige overbelastingen hebben zowel als DrawImageAbortcallbackdata parameters en kunnen gegevens doorgeven.) Als er geen gegevens zijn doorgegeven, wordt er een signaal geretourneerd true naar de aanroepmethode DrawImage dat de tekening moet worden geannuleerd. Als er gegevens zijn doorgegeven, wordt het geretourneerd false om aan te geven dat de tekening moet worden voortgezet.

Een realistische implementatie van deze callback zou betrekking hebben op de daadwerkelijke controle van bepaalde criteria om de uitvoering te annuleren of voort te zetten.

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

Opmerkingen

Deze methode wordt gebruikt in combinatie met de DrawImage methode van de Graphics klasse. Bepaalde overbelastingen van de methode roepen een door de DrawImage toepassing gedefinieerde callback-methode van dit type aan om erachter te komen of de overbelastingen moeten stoppen of de uitvoering moeten voortzetten.

Tijdens de uitvoering roepen de relevante DrawImage overbelastingen deze callbackmethode regelmatig aan om erachter te komen of ze moeten stoppen met tekenen van de opgegeven afbeelding of dat ze de afbeelding moeten blijven tekenen. De Graphics.DrawImageAbort callback-methode kan bepalen of u wilt doorgaan of niet op basis van een gekozen algoritme dat erin is opgenomen, eventueel met behulp van de gegevens die eraan worden doorgegeven door de parameter callbackdata. Een algoritme kan bijvoorbeeld bepalen of de afbeelding van het scherm is gescrold en een annulering aangeeft aan de DrawImage methode om te stoppen met tekenen.

Een gebruikersdeclaratie van deze methode voor gebeurtenisafhandeling moet dezelfde parameters hebben als de Graphics.DrawImageAbort gedelegeerdedeclaratie.