Graphics.DrawImageAbort Delegado

Definición

Proporciona un método de devolución de llamada para decidir cuándo el método DrawImage debe cancelar anticipadamente la ejecución y dejar de dibujar una imagen.Provides a callback method for deciding when the DrawImage method should prematurely cancel execution and stop drawing an image.

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
Public Delegate Function Graphics.DrawImageAbort(callbackdata As IntPtr) As Boolean 

Parámetros

callbackdata
IntPtr

Puntero interno que especifica los datos del método de devolución de llamada.Internal pointer that specifies data for the callback method. No todas las sobrecargas de DrawImage pasan este parámetro.This parameter is not passed by all DrawImage overloads. Se puede comprobar si está ausente comprobando el valor de Zero.You can test for its absence by checking for the value Zero.

Valor devuelto

Boolean

Este método devuelve true si decide que el método DrawImage debe detener la ejecución anticipadamente.This method returns true if it decides that the DrawImage method should prematurely stop execution. En caso contrario, devuelve false para indicar que el método DrawImage debe continuar con la ejecución.Otherwise it returns false to indicate that the DrawImage method should continue execution.

Herencia
Graphics.DrawImageAbort
Atributos

Ejemplos

Este ejemplo es una implementación simplista del delegado Graphics.DrawImageAbort.This example is a simplistic implementation of the Graphics.DrawImageAbort delegate. Simplemente comprueba si el método DrawImage ha pasado datos con el parámetro callBackData.It merely checks to see if the DrawImage method has passed it data using the callbackdata parameter. (Algunas sobrecargas DrawImage tienen solo un parámetro DrawImageAbort y no pasan datos; algunas sobrecargas tienen parámetros DrawImageAbort y callbackdata y pueden pasar datos). Si no se ha pasado ningún dato, devuelve true para indicar al método de DrawImage que realiza la llamada que debe cancelar el dibujo.(Some DrawImage overloads have only a DrawImageAbort parameter and pass no data; some overloads have both DrawImageAbort and callbackdata parameters and can pass data.) If no data was passed, it returns true to signal to the calling DrawImage method that it should cancel the drawing. Si se pasaron datos, devuelve false para indicar que el dibujo debe continuar.If data was passed, it returns false to signal that drawing should continue.

Una implementación realista de esta devolución de llamada implicaría el escrutinio real de algunos criterios para cancelar o continuar la ejecución.A realistic implementation of this callback would involve the actual scrutiny of some criteria to cancel or continue the execution.

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

Comentarios

Este método se utiliza junto con el método DrawImage de la clase Graphics.This method is used in conjunction with the DrawImage method of the Graphics class. Ciertas sobrecargas del método DrawImage llaman a un método de devolución de llamada definido por la aplicación de este tipo para averiguar si las sobrecargas deben detenerse o continuar la ejecución.Certain overloads of the DrawImage method call an application-defined callback method of this type to find out if the overloads should stop or continue execution.

Durante la ejecución, las sobrecargas de DrawImage relevantes llaman a este método de devolución de llamada para averiguar si deben dejar de dibujar la imagen especificada o si deben continuar dibujando la imagen.During execution, the relevant DrawImage overloads frequently call this callback method to find out if they should stop drawing the specified image or if they should continue drawing the image. El método de devolución de llamada de Graphics.DrawImageAbort puede determinar si se debe continuar o no basándose en un algoritmo elegido incluido en él, opcionalmente con los datos que le ha pasado el parámetro callBackData.The Graphics.DrawImageAbort callback method can determine whether to continue or not based on a chosen algorithm included in it, optionally using the data passed to it by the callbackdata parameter. Por ejemplo, un algoritmo puede determinar si la imagen se ha desplazado fuera de la pantalla y señalar una cancelación al método DrawImage para detener el dibujo.For example, an algorithm might determine if the image has scrolled off the screen and signal a cancellation to the DrawImage method to stop drawing.

Una declaración de usuario de este método de control de eventos debe tener los mismos parámetros que la Graphics.DrawImageAbort declaración de delegado.A user declaration of this event-handling method must have the same parameters as the Graphics.DrawImageAbort delegate declaration.

Métodos de extensión

GetMethodInfo(Delegate)

Obtiene un objeto que representa el método representado por el delegado especificado.Gets an object that represents the method represented by the specified delegate.

Se aplica a