通过

Graphics.DrawImageAbort 委托

  • 项目

提供一个回调方法，用于决定 DrawImage 方法应何时过早地取消执行并停止绘制图像。

**命名空间:**System.Drawing
**程序集:**System.Drawing（在 system.drawing.dll 中）

语法

声明
Public Delegate Function DrawImageAbort ( _
    callbackdata As IntPtr _
) As Boolean
用法
Dim instance As New DrawImageAbort(AddressOf HandlerMethod)

public delegate bool DrawImageAbort (
    IntPtr callbackdata
)

public delegate bool DrawImageAbort (
    IntPtr callbackdata
)

/** @delegate */
public delegate boolean DrawImageAbort (
    IntPtr callbackdata
)

JScript 支持使用委托，但不支持进行新的声明。

参数

  • callbackdata
    指定回调方法数据的内部指针。该参数不是由所有的 DrawImage 重载传递的。可以通过检查 Zero 值来测试它是否存在。

返回值

如果此方法决定 DrawImage 方法应过早停止执行，则此方法返回 true。否则返回 false，指示 DrawImage 方法应继续执行。

备注

此方法与 Graphics 类的 DrawImage 方法结合使用。DrawImage 方法的某些重载调用此类型的应用程序定义的回调方法，以便查明重载是应当停止还是应当继续执行。

在执行期间，相关的 DrawImage 重载频繁调用此回调方法，以查明应停止绘制指定的图像，还是应继续绘制该图像。Graphics.DrawImageAbort 回调方法可根据其中包括的选定算法（有选择地使用由 callbackdata 参数传递给它的数据）确定是否继续。例如，一种算法可以确定图像是否卷出屏幕并向 DrawImage 方法发出取消信号以停止绘图。

此事件处理方法的用户声明必须与 Graphics.DrawImageAbort 委托声明具有相同的参数。

示例

此示例是 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;
    }
 }

平台

Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

System.Drawing 命名空间