Graphics.DrawImageAbort 代理人

定義

DrawImage メソッドが、実行を早期キャンセルし、イメージの描画を停止するタイミングを決定するコールバック メソッドを提供します。Provides a callback method for deciding when the DrawImage method should prematurely cancel execution and stop drawing an image.

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 

パラメーター

callbackdata
IntPtr

コールバック メソッドのデータを指定する内部ポインター。Internal pointer that specifies data for the callback method. このパラメーターは、どの DrawImage オーバーロードでも渡されません。This parameter is not passed by all DrawImage overloads. 存在しないかどうかをテストするには、値 Zero がないかどうかを確認します。You can test for its absence by checking for the value Zero.

戻り値

Boolean

DrawImage メソッドに実行を早期停止させる場合、このメソッドは true を返します。This method returns true if it decides that the DrawImage method should prematurely stop execution. それ以外の場合は false を返して DrawImage メソッドに実行を継続させることを示します。Otherwise it returns false to indicate that the DrawImage method should continue execution.

継承
Graphics.DrawImageAbort
属性

この例は、デリゲートの単純な実装です Graphics.DrawImageAbortThis example is a simplistic implementation of the Graphics.DrawImageAbort delegate. このメソッドは、メソッドが、使用しているデータが、 DrawImage このデータパラメーターを使用して渡されたかどうかを確認するだけです。It merely checks to see if the DrawImage method has passed it data using the callbackdata parameter. (一部 DrawImage のオーバーロードは、パラメーターのみを持ち DrawImageAbort 、データを渡しません。一部のオーバーロードには、パラメーターとパラメーターの両方があり、 DrawImageAbort データを callbackdata 渡すことができます)。データが渡されなかった場合は、を返して、 true 描画をキャンセルする呼び出し元のメソッドにシグナルを送信し DrawImage ます。(Some DrawImage overloads have only a DrawImageAbort parameter and pass no data; some overloads have both DrawImageAbort and callbackdata parameters and can pass data.) If no data was passed, it returns true to signal to the calling DrawImage method that it should cancel the drawing. データが渡された場合は、を返して、 false 描画を続行することを通知します。If data was passed, it returns false to signal that drawing should continue.

このコールバックを現実的に実装するには、実行をキャンセルまたは続行するための条件を実際に調査する必要があります。A realistic implementation of this callback would involve the actual scrutiny of some criteria to cancel or continue the execution.

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 ます。This method is used in conjunction with the DrawImage method of the Graphics class. メソッドの特定のオーバーロードは DrawImage 、この型のアプリケーション定義のコールバックメソッドを呼び出して、オーバーロードが実行を停止するか続行するかを確認します。Certain overloads of the DrawImage method call an application-defined callback method of this type to find out if the overloads should stop or continue execution.

実行中、関連する DrawImage オーバーロードは、指定されたイメージの描画を停止する必要があるかどうか、またはイメージの描画を継続する必要があるかどうかを確認するために、このコールバックメソッドを頻繁に呼び出します。During execution, the relevant DrawImage overloads frequently call this callback method to find out if they should stop drawing the specified image or if they should continue drawing the image. Graphics.DrawImageAbortコールバックメソッドは、それに含まれる選択されたアルゴリズムに基づいて続行するかどうかを決定できます。オプションで、callback data パラメーターで渡されたデータを使用します。The Graphics.DrawImageAbort callback method can determine whether to continue or not based on a chosen algorithm included in it, optionally using the data passed to it by the callbackdata parameter. たとえば、アルゴリズムでは、イメージが画面の外にスクロールされたかどうかを判断し、 DrawImage 描画を停止するためにメソッドに取り消しを通知する場合があります。For example, an algorithm might determine if the image has scrolled off the screen and signal a cancellation to the DrawImage method to stop drawing.

このイベント処理メソッドのユーザー宣言は、デリゲート宣言と同じパラメーターを持っている必要があり Graphics.DrawImageAbort ます。A user declaration of this event-handling method must have the same parameters as the Graphics.DrawImageAbort delegate declaration.

拡張メソッド

GetMethodInfo(Delegate)

指定したデリゲートによって表されるメソッドを表すオブジェクトを取得します。Gets an object that represents the method represented by the specified delegate.

適用対象