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

備註

此方法與類別的方法DrawImage結合使用Graphics。 某些方法的 DrawImage 超載會呼叫此類型的應用程式定義回調方法，以判斷這些超載是否應該停止或繼續執行。

執行時，相關的 DrawImage 超載常呼叫此回調方法，以判斷是否應該停止繪製指定的影像，或是繼續繪製該影像。 Graphics.DrawImageAbort回調方法可根據其中包含的演算法決定是否繼續，並可選擇使用 callbackdata 參數傳遞的資料。 例如，演算法可能會判斷圖片是否已從螢幕上滾動，並向停止繪圖的方法發出取消 DrawImage 信號。

此事件處理方法的使用者宣告必須與代理宣告相同的參數 Graphics.DrawImageAbort 。