Graphics.DrawImageAbort 代理人

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

來源:

Graphics.cs

提供回呼 (Callback) 方法來決定 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 參數傳遞數據。 (有些多載只有DrawImageAbort參數且不傳遞任何數據;有些DrawImage多載同時具有 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;  
    }  
 }  

備註

這個方法會與類別的 Graphics 方法搭配DrawImage使用。 方法的特定多載會呼叫此類型的應用程式定義回呼方法，以找出多載 DrawImage 是否應該停止或繼續執行。

在執行期間，相關 DrawImage 多載經常呼叫這個回呼方法，以了解它們是否應該停止繪製指定的影像，或是否應該繼續繪製影像。 回 Graphics.DrawImageAbort 呼方法可以根據它中包含的所選演算法來判斷是否要繼續，選擇性地使用 callbackdata 參數傳遞給它的數據。 例如，演算法可能會判斷影像是否已從畫面捲動，並向方法發出取消 DrawImage 訊號以停止繪製。

這個事件處理方法的使用者宣告必須與委派宣告具有相同的參數 Graphics.DrawImageAbort 。

擴充方法