Graphics.DrawImageAbort 委托

定义

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

[System.Runtime.InteropServices.ComVisible(false)]
public delegate bool Graphics.DrawImageAbort(IntPtr callbackdata);

public delegate bool Graphics.DrawImageAbort(IntPtr callbackdata);

[<System.Runtime.InteropServices.ComVisible(false)>]
type Graphics.DrawImageAbort = delegate of nativeint -> bool

type Graphics.DrawImageAbort = delegate of nativeint -> bool

Public Delegate Function Graphics.DrawImageAbort(callbackdata As IntPtr) As Boolean 

参数

返回值

如果此方法决定该方法应过早停止执行，则DrawImage返回true此方法。 否则，它将返回 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;
    }
 }

注解

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

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

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