LEADTOOLS画像ファイルサポート(Leadtools.Codecsアセンブリ)

フレームを表示

CodecsLoadAsyncCompletedEventArgsクラス








メンバ 
RasterCodecs.LoadAsyncCompletedイベントのためのデータを格納します。
オブジェクトモデル
構文
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のデータ引数オブジェクトを使います。このクラスは、以下のプロパティを格納します:

プロパティ 説明
ウーリStreamFileName

この非同期動作を初期化したメソッドに渡されるURI、ストリームまたはファイル名を格納します。

常に、これらのプロパティのいずれか1つのみが有効な値(null参照ではない値)になります。どのプロパティに有効な参照が含まれるかは、どのバージョンのRasterCodecs.LoadAsyncメソッドが呼び出されたかによって決まります。

たとえばRasterCodecs.LoadAsync(ウーリuri、オブジェクトuserState)が呼び出されている場合、Uriにはメソッドに渡されるものと同じURIが含まれ、StreamFileNameはどちらも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を呼び出すことによって

サンプル
サンプルのために、参照しますRasterCodecs.LoadAsyncCompleted
必要条件

ターゲットプラットホーム

参照

参照

CodecsLoadAsyncCompletedEventArgsメンバ
Leadtools.Codecs名前空間