Graphics.DrawImageAbort Delegado

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Source:

Graphics.cs

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.

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

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

nativeint

Puntero interno que especifica los datos del método de devolución de llamada. No todas las sobrecargas de DrawImage pasan este parámetro. Se puede comprobar si está ausente comprobando el valor de Zero.

Valor devuelto

Boolean

Este método devuelve true si decide que el método DrawImage debe detener la ejecución anticipadamente. En caso contrario, devuelve false para indicar que el método DrawImage debe continuar con la ejecución.

Ejemplos

Este ejemplo es una implementación simplista del Graphics.DrawImageAbort delegado. Simplemente comprueba si el DrawImage método lo ha pasado con el parámetro callbackdata. (Algunas DrawImage sobrecargas solo tienen un DrawImageAbort parámetro y no pasan datos; algunas sobrecargas tienen parámetros DrawImageAbort y callbackdata y pueden pasar datos). Si no se ha pasado ningún dato, vuelve true a indicar al método de llamada DrawImage que debe cancelar el dibujo. Si se han pasado los datos, devuelve false para indicar que el dibujo debe continuar.

Una implementación realista de esta devolución de llamada implicaría el examen real de algunos criterios para cancelar o continuar la ejecución.

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 usa junto con el DrawImage método de la Graphics clase . Ciertas sobrecargas del método llaman a un método de devolución de llamada definido por la DrawImage aplicación de este tipo para averiguar si las sobrecargas deben detener o continuar la ejecución.

Durante la ejecución, las sobrecargas pertinentes DrawImage suelen llamar 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. El Graphics.DrawImageAbort método de devolución de llamada puede determinar si continuar o no en función de un algoritmo elegido incluido en él, opcionalmente mediante los datos pasados por el parámetro callbackdata. Por ejemplo, un algoritmo podría determinar si la imagen se ha desplazado fuera de la pantalla y indicar una cancelación al método para detener el DrawImage dibujo.

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.

Métodos de extensión