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

フレームを表示

GetInformationAsync(ウーリ、Boolean、Int32、Object)メソッド








入力イメージデータを格納しているウーリ
総頁数のためにURIを問い合わせる場合はTrue;それ以外の場合はFalseです。
問い合わせるページ番号。(最初のページのためのパス1)デフォルト。
非同期操作の完了時に呼び出されるメソッドに渡されるユーザー定義オブジェクト。
非同期で指定されたウーリから特定のimageページ情報を取得します。
構文
public CodecsImageInfo GetInformationAsync( 
   Uri uri,
   bool totalPages,
   int pageNumber,
   object userState
)
'Declaration
 
Public Overloads Function GetInformationAsync( _
   ByVal uri As Uri, _
   ByVal totalPages As Boolean, _
   ByVal pageNumber As Integer, _
   ByVal userState As Object _
) As CodecsImageInfo
'Usage
 
Dim instance As RasterCodecs
Dim uri As Uri
Dim totalPages As Boolean
Dim pageNumber As Integer
Dim userState As Object
Dim value As CodecsImageInfo
 
value = instance.GetInformationAsync(uri, totalPages, pageNumber, userState)
public CodecsImageInfo GetInformationAsync( 
   Uri uri,
   bool totalPages,
   int pageNumber,
   object userState
)
 function Leadtools.Codecs.RasterCodecs.GetInformationAsync(Uri,Boolean,Int32,Object)( 
   uri ,
   totalPages ,
   pageNumber ,
   userState 
)
public:
CodecsImageInfo^ GetInformationAsync( 
   Uri^ uri,
   bool totalPages,
   int pageNumber,
   Object^ userState
) 

パラメーター

uri
入力イメージデータを格納しているウーリ
totalPages
総頁数のためにURIを問い合わせる場合はTrue;それ以外の場合はFalseです。
pageNumber
問い合わせるページ番号。(最初のページのためのパス1)デフォルト。
userState
非同期操作の完了時に呼び出されるメソッドに渡されるユーザー定義オブジェクト。

戻り値

指定されたimageに関する情報を格納するCodecsImageInfoオブジェクト。このオブジェクトの使用法については、「解説」を参照してください。
解説

totalPagesにtrueを指定すると、ページ数の多いファイルのためプロセスは遅くなります。

LEADTOOLSは、以下のURI計画をサポートします:
仕組み 説明
UriSchemeFile URIがローカルマシンまたは一般的な命名規約(UNC)パスのディスクファイルであることを示しています。
UriSchemeHttp URIがハイパーテキストトランスファープロトコル(HTTP)を通してアクセスされることを示しています。
UriSchemeHttps URIがセキュアなハイパーテキストトランスファープロトコル(HTTPS)を通してアクセスされることを示しています。
UriSchemeFtp URIがファイル転送プロトコル(FTP)を通してアクセスされることを示しています。

uriUriSchemeHttpUriSchemeHttpsまたはUriSchemeFtpで資源をポイントするならば、このRasterCodecsは一時バッファを作成することによって反復やり方で画像データをダウンロードしようとします。このバッファのサイズは、このメソッドを呼び出す前にUriOperationBufferSizeを準備することによって決定されることができて、変更されることができます。

確実性とプロキシ設定のために、UriOperationCredentialsUriOperationProxyを参照します。

RasterCodecsクラスは、GetInformationAsyncメソッドを使って画像ファイルに関する情報を非同期に取得するようサポートします。これらのいずれかのメソッドを呼び出すと、コーラースレッドはブロックされ、ロード状態にあるインスタンスCodecsImageInfoでただちに返されます(CodecsImageInfo.IsLoadingをtrueに設定)。オブジェクトがロード状態にある間は、このオブジェクトのその他のプロパティは使用してはなりません。

RasterCodecsオブジェクトでファイルに関する情報の取得が終わると、CodecsImageInfoの様々なプロパティには画像ファイル情報が入力され、CodecsImageInfo.IsLoadingプロパティはfalseに設定されます。

画像情報の収集が完了したかどうかを判断するためにCodecsImageInfo.IsLoadingプロパティをポーリングすることは推奨されません。そうではなく、GetInformationAsync操作がいつ完了するのか、エラーが発生したかどうかに関する情報を得るにはGetInformationAsyncCompletedイベントにサブスクライブします。

GetInformationAsyncCompletedイベントデータにはGetInformationAsyncから返されたものと同じオブジェクトも含まれます。このためアプリケーション内にオリジナルのオブジェクトを保持しておく必要はありません。

userStateは、GetInformationAsyncCompletedイベントデータのCodecsGetInformationAsyncCompletedEventArgs.UserStateメンバに渡されます。

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

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

参照

参照

RasterCodecsクラス
RasterCodecsメンバ
オーバーロードリスト
大きなTIFF/BigTIFFファイルのロードと保存
1ビット画像処理の高速化