Graphics.DrawImageAbort Делегат

Определение

Предоставляет метод обратного вызова, используемый в случае, когда метод DrawImage должен преждевременно отменить выполнение и прекратить рисование изображения.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 

Параметры

callbackdata
IntPtr

Внутренний указатель, определяющий данные для метода обратного вызова.Internal pointer that specifies data for the callback method. Этот параметр не передается всеми перегруженными членами DrawImage.This parameter is not passed by all DrawImage overloads. Проверить, отсутствует ли этот параметр, можно путем проверки значения Zero.You can test for its absence by checking for the value Zero.

Возвращаемое значение

Boolean

Данный метод возвращает значение true, если принимается решение, что метод DrawImage должен преждевременно прекратить выполнение.This method returns true if it decides that the DrawImage method should prematurely stop execution. В противном случае возвращается значение false, указывающее на необходимость продолжения выполнения метода DrawImage.Otherwise it returns false to indicate that the DrawImage method should continue execution.

Наследование
Graphics.DrawImageAbort
Атрибуты

Примеры

Этот пример представляет собой упрощенную реализацию Graphics.DrawImageAbort делегата.This example is a simplistic implementation of the Graphics.DrawImageAbort delegate. Он просто проверяет, прошли ли DrawImage метод данные, используя параметр каллбаккдата.It merely checks to see if the DrawImage method has passed it data using the callbackdata parameter. (Некоторые DrawImage перегрузки имеют DrawImageAbort только параметр и не передают данные; некоторые перегрузки имеют DrawImageAbort и параметры callbackdata , и могут передавать данные.) Если данные не передавались, возвращается true , чтобы сообщить вызывающему DrawImage методу, что он должен отменить рисование.(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. Если данные переданы, он возвращает false , чтобы сообщить, что рисование должно быть продолжено.If data was passed, it returns false to signal that drawing should continue.

Реалистичная реализация этого обратного вызова повлечет за собой фактическую тщательность некоторых критериев для отмены или продолжения выполнения.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;  
    }  
 }  

Комментарии

Этот метод используется в сочетании с DrawImage методом Graphics класса.This method is used in conjunction with the DrawImage method of the Graphics class. Некоторые перегрузки DrawImage метода вызывают определенный приложением метод обратного вызова этого типа, чтобы определить, следует ли прекратить или продолжить выполнение перегрузок.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.

Во время выполнения соответствующие DrawImage перегрузки часто вызывают этот метод обратного вызова, чтобы определить, следует ли прекратить прорисовку указанного изображения или они должны продолжить рисование изображения.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. Метод Graphics.DrawImageAbort обратного вызова может определить, следует ли продолжить или не использовать выбранный в нем алгоритм, при необходимости используя данные, передаваемые им с помощью параметра каллбаккдата.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. Например, алгоритм может определить, прокручивается ли изображение за пределы экрана, и сигнализирует об отмене DrawImage метода для остановки рисования.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.

Объявление пользователя этого метода обработки событий должно иметь те же параметры, что Graphics.DrawImageAbort и объявление делегата.A user declaration of this event-handling method must have the same parameters as the Graphics.DrawImageAbort delegate declaration.

Методы расширения

GetMethodInfo(Delegate)

Получает объект, представляющий метод, представленный указанным делегатом.Gets an object that represents the method represented by the specified delegate.

Применяется к