Graphics.DrawImageAbort 委托

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

Source:

Graphics.cs

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

public: delegate bool Graphics::DrawImageAbort(IntPtr callbackdata);

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

nativeint

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

返回值

Boolean

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

示例

此示例是委托的 Graphics.DrawImageAbort 简单实现。 它只是检查方法是否已 DrawImage 使用 callbackdata 参数传递数据。 (某些 DrawImage 重载只有一个 DrawImageAbort 参数，不传递任何数据;某些重载同时 DrawImageAbort 具有 和 callbackdata 参数，并且可以传递 data。) 如果未传递任何数据，则返回 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;  
    }  
 }  

注解

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

在执行期间，相关 DrawImage 重载会频繁调用此回调方法，以确定它们是否应停止绘制指定图像，或者是否应继续绘制图像。 回调 Graphics.DrawImageAbort 方法可以根据其中包含的所选算法确定是否继续，可以选择使用由 callbackdata 参数传递给它的数据。 例如，算法可以确定图像是否已从屏幕滚动，并向 方法发出取消 DrawImage 信号以停止绘制。

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

扩展方法