ハンドルオブジェクト（IHandle インターフェイス）

このオブジェクトは、メモリ内のリソースのハンドルにアクセスするためのものです。ビットマップイメージまたはメモリブロックへのアクセスを提供する一部のメソッドから返されます。このオブジェクトはメモリの割り当てを管理し、これらのリソースの操作時にメモリリークを防ぐことができます。

このインターフェイスは自動化をサポートしていません。つまり、FineReader Engine がアウトオブプロセスサーバーとして読み込まれている場合、Linux および Windows では動作しません。

このオブジェクトは、次のような場合に使用します。

FineReader Engine の外部でリソースを使用する場合

ハンドルプロパティを使用してリソースのハンドルを取得し、それを使って操作できます。この場合、ハンドルオブジェクトを解放すると、リソースも解放されます。あるいは、ハンドルを取得した後でハンドルオブジェクトをそこから切り離すこともできます (Detach メソッドを使用) 。この場合は、リソースの解放をユーザー側で行う必要があります。

リソースを FineReader Engine の別のメソッドに渡す場合

HandleAsInt64 プロパティを使用すると、リソースのハンドルを __int64 として取得できます。後で、このプロパティの値を必要とする FineReader Engine のメソッドに渡すことができます。ハンドルオブジェクトを解放すると、リソースも解放されます。CloseHandle メソッドを呼び出して、リソースを手動で解放することもできます。

プロパティ

名前	型	説明
Application	Engine, 読み取り専用	Engine オブジェクトを返します。
Handle	HANDLE*, 読み取り専用	リソースのハンドルを返します。このプロパティからハンドルを取得して、リソースを操作できます。
HandleAsInt64	__int64, 読み取り専用	リソースのハンドルを __int64 として返します。このプロパティの戻り値は、FineReader Engine のメソッドに入力パラメーターとして渡すことができます。

メソッド

名前	説明
CloseHandle	リソースを解放します。
Detach	ハンドルを返し、オブジェクトとの関連付けを解除します。

出力パラメーター

このオブジェクトは、次のメソッドの出力パラメーターです。

Image オブジェクトの GetBitmap メソッド
複数のオブジェクトの SaveToMemory メソッド (Windows)

サンプル

C# コード

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// ドキュメントは作成済みで、画像が追加されているものとします
// ドキュメントページのカラー画像プレーンのビットマップハンドルを取得します
FREngine.IFRPage page = frDoc.Pages[0];
FREngine.IImageDocument imageDoc = page.ImageDocument;
FREngine.IImage image = imageDoc.ColorImage;
FREngine.IHandle hBitmap = image.GetBitmap( null );
// ビットマップを処理します
System.Drawing.IImage preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
...
Gdi32.DeleteObject( hBitmap );

このオブジェクトは、次の Windows デモツールで使用されています。Engine Predefined Processing Profiles。

​プロパティ

​メソッド

​出力パラメーター

​サンプル

​関連項目

プロパティ

メソッド

出力パラメーター

サンプル

関連項目