Graphics.DrawImageAbort Delegar

Definição

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

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

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

Public Delegate Function Graphics.DrawImageAbort(callbackdata As IntPtr) As Boolean 

Parâmetros

Devolver Valor

Este método retorna true se decidir que o DrawImage método deve parar prematuramente a execução. Caso contrário, volta false a indicar que o DrawImage método deve continuar a execução.

Atributos

ComVisibleAttribute

Exemplos

Este exemplo é uma implementação simplista do Graphics.DrawImageAbort delegado. Limita-se a verificar se o DrawImage método lhe transmitiu dados usando o parâmetro callbackdata. (Algumas DrawImage sobrecargas têm apenas um DrawImageAbort parâmetro e não passam dados; algumas sobrecargas têm ambos DrawImageAbort os parâmetros e callbackdata podem passar dados.) Se nenhum dado for passado, retorna true para sinalizar ao método que chama DrawImage que deve cancelar o desenho. Se os dados foram passados, o desenho retorna false para sinalizar que o desenho deve continuar.

Uma implementação realista deste callback implicaria o escrutínio efetivo de alguns critérios para cancelar ou continuar a execução.

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

Observações

Este método é usado em conjunto com o DrawImage método da Graphics turma. Certas sobrecargas do DrawImage método chamam um método de callback definido pela aplicação deste tipo para determinar se as sobrecargas devem parar ou continuar a execução.

Durante a execução, as sobrecargas relevantes DrawImage frequentemente chamam este método de callback para determinar se devem parar de desenhar a imagem especificada ou se devem continuar a desenhá-la. O Graphics.DrawImageAbort método de callback pode determinar se continua ou não com base num algoritmo escolhido incluído, utilizando opcionalmente os dados passados pelo parâmetro callbackdata. Por exemplo, um algoritmo pode determinar se a imagem se deslocou para fora do ecrã e sinalizar um cancelamento ao DrawImage método para parar de desenhar.

Uma declaração de utilizador deste método de gestão de eventos deve ter os mesmos parâmetros que a Graphics.DrawImageAbort declaração de delegado.