Graphics.DrawImageAbort Делегат

Определение

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 

Параметры

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

Этот метод возвращается true , если он решает, что DrawImage метод должен преждевременно остановить выполнение. В противном случае возвращается false значение, указывающее, что DrawImage метод должен продолжать выполнение.

Атрибуты

ComVisibleAttribute

Примеры

Этот пример является упрощенной реализацией делегата Graphics.DrawImageAbort . Он просто проверяет, передает ли DrawImage метод данные с помощью параметра callbackdata. (Некоторые перегрузки имеют только DrawImage параметр и не передают данные; некоторые DrawImageAbort перегрузки имеют оба DrawImageAbort и callbackdata параметры и могут передавать данные.) Если данные не были переданы, он возвращает true сигнал вызывающему DrawImage методу, что он должен отменить рисунок. Если данные были переданы, он возвращает false сигнал о том, что рисование должно продолжаться.

Реалистичная реализация этого обратного вызова будет включать фактическое изучение некоторых критериев для отмены или продолжения выполнения.

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

Комментарии

Этот метод используется в сочетании с методом DrawImageGraphics класса. Некоторые перегрузки DrawImage метода вызывают определяемый приложением метод обратного вызова этого типа, чтобы узнать, должны ли перегрузки остановить или продолжить выполнение.

Во время выполнения соответствующие DrawImage перегрузки часто вызывают этот метод обратного вызова, чтобы узнать, следует ли остановить рисование указанного изображения или продолжить рисование изображения. Метод Graphics.DrawImageAbort обратного вызова может определить, следует ли продолжать или нет на основе выбранного алгоритма, включенного в него, при необходимости с использованием данных, передаваемых параметром callbackdata. Например, алгоритм может определить, прокручивается ли изображение с экрана и сигнализирует об отмене DrawImage метода, чтобы остановить рисование.

Объявление пользователя этого метода обработки событий должно иметь те же параметры, что и объявление делегата Graphics.DrawImageAbort .