Leadtools.Codecs名前空間 :CodecsLoadAsyncCompletedEventArgsクラス |
public class CodecsLoadAsyncCompletedEventArgs : CodecsAsyncCompletedEventArgs
'Declaration
Public Class CodecsLoadAsyncCompletedEventArgs Inherits CodecsAsyncCompletedEventArgs
'Usage
Dim instance As CodecsLoadAsyncCompletedEventArgs
public sealed class CodecsLoadAsyncCompletedEventArgs : CodecsAsyncCompletedEventArgs
public class CodecsLoadAsyncCompletedEvent extends CodecsAsyncCompletedEvent
function Leadtools.Codecs.CodecsLoadAsyncCompletedEventArgs()
public ref class CodecsLoadAsyncCompletedEventArgs : public CodecsAsyncCompletedEventArgs
RasterCodecsクラスは、RasterCodecs.LoadAsyncメソッドを用いて非同期でロード画像ファイルをサポートします。これらのいずれかのメソッドを呼び出すと、コーラースレッドはブロックされ、ロード状態にあるインスタンスRasterImageのでただちに返されます(プロパティがそうであるtheRasterImage.IsLoadingをtrueに設定)。オブジェクトがステータスをロードすることの中にある間、このオブジェクトの他のプロパティを使いません。
RasterCodecsオブジェクトがimageをロードするを完了するとき、RasterImageのいろいろなプロパティは画像情報で値を入力されます、そして、データとRasterImage.IsLoadingプロパティはfalseに設定されます。
imageがロードされて終わるかどうか決定するために、RasterImage.IsLoadingプロパティを得票しません。代わりに、通知を取得するために、RasterCodecs.LoadAsyncCompletedイベントに、LoadAsync操作が完了されるとき、そして、任意のエラーが発生したかどうかにかかわらず、サブスクライブします。
RasterCodecs.LoadAsyncCompletedイベントデータにはRasterCodecs.LoadAsyncから返されたものと同じオブジェクトも含まれます。このためアプリケーション内にオリジナルのオブジェクトを保持しておく必要はありません。
RasterCodecs.LoadAsyncCompletedイベントは、型CodecsLoadAsyncCompletedEventArgsのデータ引数オブジェクトを使います。このクラスは、以下のプロパティを格納します:
プロパティ | 説明 |
---|---|
ウーリ、StreamとFileName |
この非同期動作を初期化したメソッドに渡されるURI、ストリームまたはファイル名を格納します。 常に、これらのプロパティのいずれか1つのみが有効な値(null参照ではない値)になります。どのプロパティに有効な参照が含まれるかは、どのバージョンのRasterCodecs.LoadAsyncメソッドが呼び出されたかによって決まります。 たとえばRasterCodecs.LoadAsync(ウーリuri、オブジェクトuserState)が呼び出されている場合、Uriにはメソッドに渡されるものと同じURIが含まれ、StreamとFileNameはどちらもNULLになります。RasterCodecs.LoadAsync(String fileName、オブジェクトuserState)が呼び出されている場合、FileNameにはメソッドに渡されるものと同じファイル名の文字列値が含まれ、ウーリとStreamはどちらもNULLになる、等です。 |
image |
ロードされている画像データを格納するRasterImageクラスインスタンスを格納します。このインスタンスは、RasterCodecs.LoadAsyncメソッドから返される同じオブジェクトです。非同期操作の実行中は、RasterImage.IsLoadingプロパティの値がtrueになります。これは、現在このオブジェクトに画像情報を格納している最中であり、このオブジェクトを使用すべきでないことを示します。操作が完了する非同期、イベントが発生するRasterCodecs.LoadAsyncCompletedとimageがいつ最終的であるものとすぐに使えるものを格納するかオブジェクト。エラーが発生するならば、このプロパティはnullに設定されます、そして、オブジェクトはツールキットで内部的に破棄されます。 |
エラー |
非同期動作の間、発生したかもしれない任意のエラーを格納します。RasterCodecs.LoadAsyncCompletedイベントが発生するこの値を確認しなければならなくて、それが有効な例外を格納しないことを確認しなければなりませんオブジェクト。 |
キャンセルされます |
非同期動作がキャンセルされたかどうか示している値を格納します。たとえば、URLでRasterCodecs.LoadAsyncを使うとき、RasterCodecs.CancelAsyncを呼び出すことによって |