メインコンテンツへスキップ
このメソッドは、Linux 版および Windows 版の FRE で実装されています。
このメソッドはクライアント側で実装されます。ソースの画像処理キューから次の画像ファイルを返します。
Windows で、すでにメモリに読み込まれている画像を扱う場合 (たとえば、Engine オブジェクトの OpenBitmap または OpenDib メソッドを使用する場合) は、GetNextImageDocument を実装してください。
GetNextImageFile メソッドの実装には、次の画像ファイルを待機する時間を含めることができます。ただし、FineReader Engine はマルチスレッドではないため、長い待機時間を設けることは推奨されません。次のファイルを待機している間、Engine は認識プロセスからのメッセージを処理できず、特定のページが処理済みであることを示す通知も受け取れません。長い待機時間を指定する必要がある場合は、GetNextImageFile メソッドが 0 を返すことがあります。この場合、Engine は認識プロセスからのメッセージ処理と認識済み画像の提供を継続し、しばらくしてから画像キューが空かどうかを確認します。キューが空でない場合 (つまり、IImageSource::IsEmpty が FALSE を返す場合) 、Engine は GetNextImageFile メソッドを再度呼び出します。ただし、GetNextImageFile メソッドが 0 を返し、処理対象のページがもうない場合、FineReader Engine は制御をユーザーに戻します。つまり、IBatchProcessor::GetNextProcessedPage メソッドは 0 を返します。

構文

C++

HRESULT GetNextImageFile( IFileAdapter** Result );

C#

IFileAdapter GetNextImageFile();

Visual Basic .NET

Function GetNextImageFile() As IFileAdapter

パラメーター

Result [out, retval] キュー内の次の画像ファイルにアクセスするための IFileAdapter* ポインター変数へのポインター。

戻り値

[C++ のみ] このメソッドから S_OK 以外の値が返された場合は、クライアント側でエラーが発生したことを示します。

注記

  • このメソッドのクライアント実装では、メソッド内でスローされるすべての例外を必ずキャッチして処理し、例外がメソッドの外部へ伝播しないようにする必要があります。例外がメソッドの外部へ伝播すると、予期しない結果 (プログラムの終了など) を招くおそれがあります。
  • お使いのライセンスに Office Formats Opening モジュールが含まれている場合は、このメソッドを使用して、サポートされている形式 のデジタルドキュメントを開くこともできます。

サンプル

// 画像ファイルのキューを保持するカスタム画像ソースの実装例
public class ImageSourceCallback : FREngine.IImageSource
{
   public ImageSourceCallback( string imageFilesDirectory )
   {
       imageFiles = ImageSourceHelper.LoadFilesNames( imageFilesDirectory );
       nextFileIndex = 0;
   }
   public bool IsEmpty()
   {
       return nextFileIndex >= imageFiles.Length;
   }
   public FREngine.IFileAdapter GetNextImageFile()
   {
       if( !IsEmpty() ) {
           return new FileAdapterCallback( imageFiles[nextFileIndex++] );
       }
       return null;
   }
   public FREngine.IImageDocument GetNextImageDocument()
   {
       ...
   }
   private string[] imageFiles;
   private int nextFileIndex;
}
public class FileAdapterCallback : FREngine.IFileAdapter
{
    ...
}
public class ImageSourceHelper
{
    ...
}

関連項目

IImageSource GetNextImageDocument IsEmpty IFileAdapter