Graphics.DrawImageAbort Delegar

Definição

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.Provides a callback method for deciding when the DrawImage method should prematurely cancel execution and stop drawing an image.

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
Public Delegate Function Graphics.DrawImageAbort(callbackdata As IntPtr) As Boolean 

Parâmetros

callbackdata
IntPtr

Ponteiro interno que especifica os dados para o método de retorno de chamada.Internal pointer that specifies data for the callback method. Esse parâmetro não é passado por todas as sobrecargas DrawImage.This parameter is not passed by all DrawImage overloads. É possível testar sua ausência verificando se o valor Zero existe.You can test for its absence by checking for the value Zero.

Valor Retornado

Boolean

Esse método retornará true se decidir que o método DrawImage deve interromper a execução prematuramente.This method returns true if it decides that the DrawImage method should prematurely stop execution. Caso contrário, retornará false para indicar que o método DrawImage deve continuar a execução.Otherwise it returns false to indicate that the DrawImage method should continue execution.

Herança
Graphics.DrawImageAbort
Atributos

Exemplos

Este exemplo é uma implementação simplista do Graphics.DrawImageAbort delegado.This example is a simplistic implementation of the Graphics.DrawImageAbort delegate. Ele simplesmente verifica se o método de DrawImage passou os dados usando o parâmetro callbackdata.It merely checks to see if the DrawImage method has passed it data using the callbackdata parameter. (Algumas DrawImage sobrecargas têm apenas um parâmetro DrawImageAbort e não transmitem dados; algumas sobrecargas têm ambos os parâmetros DrawImageAbort e callbackdata e podem passar dados.) Se nenhum dado foi passado, ele retornará true para sinalizar ao método de DrawImage de chamada que deve cancelar o desenho.(Some DrawImage overloads have only a DrawImageAbort parameter and pass no data; some overloads have both DrawImageAbort and callbackdata parameters and can pass data.) If no data was passed, it returns true to signal to the calling DrawImage method that it should cancel the drawing. Se os dados foram passados, ele retornará false para sinalizar que o desenho deve continuar.If data was passed, it returns false to signal that drawing should continue.

Uma implementação realista desse retorno de chamada envolveria a investigação real de alguns critérios para cancelar ou continuar a execução.A realistic implementation of this callback would involve the actual scrutiny of some criteria to cancel or continue the execution.

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 método DrawImage da classe Graphics.This method is used in conjunction with the DrawImage method of the Graphics class. Determinadas sobrecargas do método DrawImage 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.Certain overloads of the DrawImage method call an application-defined callback method of this type to find out if the overloads should stop or continue execution.

Durante a execução, as sobrecargas DrawImage relevantes geralmente chamam esse método de retorno de chamada para descobrir se eles devem parar de desenhar a imagem especificada ou se devem continuar desenhando a imagem.During execution, the relevant DrawImage overloads frequently call this callback method to find out if they should stop drawing the specified image or if they should continue drawing the image. O método de retorno de chamada Graphics.DrawImageAbort pode determinar se deseja continuar ou não com base em um algoritmo escolhido incluído nele, opcionalmente usando os dados passados para ele pelo parâmetro callbackdata.The Graphics.DrawImageAbort callback method can determine whether to continue or not based on a chosen algorithm included in it, optionally using the data passed to it by the callbackdata parameter. Por exemplo, um algoritmo pode determinar se a imagem foi rolada para fora da tela e sinalizar um cancelamento para o método DrawImage para interromper o desenho.For example, an algorithm might determine if the image has scrolled off the screen and signal a cancellation to the DrawImage method to stop drawing.

Uma declaração de usuário desse método de manipulação de eventos deve ter os mesmos parâmetros que a declaração de delegado de Graphics.DrawImageAbort.A user declaration of this event-handling method must have the same parameters as the Graphics.DrawImageAbort delegate declaration.

Métodos de Extensão

GetMethodInfo(Delegate)

Obtém um objeto que representa o método representado pelo delegado especificado.Gets an object that represents the method represented by the specified delegate.

Aplica-se a