Graphics.DrawImageAbort Delegar

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

Graphics.cs

Fornece um método de retorno de chamada para decidir quando o método DrawImage deve cancelar a execução prematuramente e interromper o desenho de uma imagem.

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

Ponteiro interno que especifica os dados para o método de retorno de chamada. Esse parâmetro não é passado por todas as sobrecargas DrawImage. É possível testar sua ausência verificando se o valor Zero existe.

Valor Retornado

Boolean

Esse método retornará true se decidir que o método DrawImage deve interromper a execução prematuramente. Caso contrário, retornará false para indicar que o método DrawImage deve continuar a execução.

Exemplos

Este exemplo é uma implementação simplista do Graphics.DrawImageAbort delegado. Ele apenas verifica se o DrawImage método passou os 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 parâmetros DrawImageAbort e callbackdata e podem passar dados.) Se nenhum dado tiver sido passado, ele retornará true para sinalizar ao método de chamada DrawImage que ele deve cancelar o desenho. Se os dados foram passados, ele retorna false para sinalizar que o desenho deve continuar.

Uma implementação realista desse retorno de chamada envolveria o escrutínio real 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;  
    }  
 }  

Comentários

Esse método é usado em conjunto com o DrawImage método da Graphics classe . Determinadas sobrecargas do DrawImage método chamam um método de retorno de chamada definido pelo aplicativo desse tipo para descobrir se as sobrecargas devem parar ou continuar a execução.

Durante a execução, as sobrecargas relevantes DrawImage frequentemente chamam esse método de retorno de chamada para descobrir se devem parar de desenhar a imagem especificada ou se devem continuar desenhando a imagem. O Graphics.DrawImageAbort método de retorno de chamada pode determinar se deve ou não continuar com base em um algoritmo escolhido incluído nele, opcionalmente usando os dados passados para ele pelo parâmetro callbackdata. Por exemplo, um algoritmo pode determinar se a imagem foi rolada para fora da tela e sinalizar um cancelamento para o DrawImage método para parar de desenhar.

Uma declaração de usuário desse método de manipulação de eventos deve ter os mesmos parâmetros que a Graphics.DrawImageAbort declaração de delegado.

Métodos de Extensão