このオブジェクトは、メモリ内のリソースのハンドルにアクセスするためのものです。ビットマップ イメージまたはメモリ ブロックへのアクセスを提供する一部のメソッドから返されます。このオブジェクトはメモリの割り当てを管理し、これらのリソースの操作時にメモリ リークを防ぐことができます。
このインターフェイスは自動化をサポートしていません。つまり、FineReader Engine がアウトオブプロセス サーバーとして読み込まれている場合、Linux および Windows では動作しません。
- FineReader Engine の外部でリソースを使用する場合
Handle プロパティを使用してリソースのハンドルを取得し、それを使って操作できます。この場合、Handle オブジェクトを解放すると、リソースも解放されます。あるいは、ハンドルを取得した後で Handle オブジェクトをそこから切り離すこともできます (Detach メソッドを使用) 。この場合は、リソースの解放をユーザー側で行う必要があります。
- リソースを FineReader Engine の別のメソッドに渡す場合
HandleAsInt64 プロパティを使用すると、リソースのハンドルを __int64 として取得できます。後で、このプロパティの値を必要とする FineReader Engine のメソッドに渡すことができます。Handle オブジェクトを解放すると、リソースも解放されます。CloseHandle メソッドを呼び出して、リソースを手動で解放することもできます。
| 名前 | 型 | 説明 |
|---|
| Application | Engine, 読み取り専用 | Engine オブジェクトを返します。 |
| Handle | HANDLE*, 読み取り専用 | リソースのハンドルを返します。このプロパティからハンドルを取得して、リソースを操作できます。 |
| HandleAsInt64 | __int64, 読み取り専用 | リソースのハンドルを __int64 として返します。このプロパティの戻り値は、FineReader Engine のメソッドに入力パラメーターとして渡すことができます。 |
| 名前 | 説明 |
|---|
| CloseHandle | リソースを解放します。 |
| Detach | ハンドルを返し、オブジェクトとの関連付けを解除します。 |
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 );
