Graphics.DrawImageAbort Delegar
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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);[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 -> boolPublic 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
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.
- Atributos
Exemplos
Este exemplo é uma implementação simplista do Graphics.DrawImageAbort delegado. Ele apenas verifica se o DrawImage método passou 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 DrawImageAbort parâmetros 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 forem passados, ele retornará 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 continuar ou não 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 método para interromper o DrawImage desenho.
Uma declaração de usuário desse método de tratamento de eventos deve ter os mesmos parâmetros que a Graphics.DrawImageAbort declaração de delegado.
Métodos de Extensão
| GetMethodInfo(Delegate) |
Obtém um objeto que representa o método representado pelo delegado especificado. |
