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を返します。 それ以外の場合は、DrawImage メソッドが実行を続行する必要があることを示すfalseが返されます。

属性

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

注釈

このメソッドは、Graphics クラスの DrawImage メソッドと組み合わせて使用されます。 DrawImage メソッドの特定のオーバーロードは、この型のアプリケーション定義コールバック メソッドを呼び出して、オーバーロードが実行を停止または続行する必要があるかどうかを確認します。

実行中、関連する DrawImage オーバーロードは、このコールバック メソッドを頻繁に呼び出して、指定したイメージの描画を停止する必要があるかどうか、またはイメージの描画を続行する必要があるかどうかを調べる必要があります。 Graphics.DrawImageAbortコールバック メソッドは、それに含まれる選択したアルゴリズムに基づいて続行するかどうかを決定できます。必要に応じて、callbackdata パラメーターによって渡されたデータを使用します。 たとえば、画像が画面からスクロールしたかどうかをアルゴリズムで判断し、 DrawImage メソッドにキャンセルを通知して描画を停止できます。

このイベント処理メソッドのユーザー宣言には、 Graphics.DrawImageAbort デリゲート宣言と同じパラメーターが必要です。