Graphics.DrawImageAbort Delegado

Definición

Espacio de nombres:
System.Drawing
Ensamblado:
System.Drawing.dll

Proporciona un método de devolución de llamada para decidir cuándo el método debe cancelar prematuramente la DrawImage ejecución y detener el dibujo de una imagen.

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

Parámetros

callbackdata
IntPtr

nativeint

Puntero interno que especifica datos para el método de devolución de llamada. No se pasa este parámetro por todas las DrawImage sobrecargas. Puede probar su ausencia comprobando el valor Zero.

Valor devuelto

Boolean

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

Atributos
ComVisibleAttribute

Ejemplos

Este ejemplo es una implementación simplista del Graphics.DrawImageAbort delegado. Simplemente comprueba si el DrawImage método lo ha pasado mediante 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 pueden pasar datos). Si no se pasó ningún dato, vuelve true a indicar al método de llamada DrawImage que debe cancelar el dibujo. Si se han pasado datos, vuelve false a 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 . Algunas 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 seguir 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

Nombre Description
GetMethodInfo(Delegate)

Obtiene un objeto que representa el método representado por el delegado especificado.

Se aplica a