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

備註

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

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

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

擴充方法