Saltar al contenido principal
Este objeto proporciona acceso al handle de un recurso en memoria. Lo devuelven algunos métodos que proporcionan acceso a una imagen bitmap o a un bloque de memoria. El objeto administra la asignación de memoria y le permite evitar fugas de memoria al trabajar con estos recursos.
Esta interfaz no admite automatización. Esto significa que no funciona en Linux ni en Windows si FineReader Engine se carga como un servidor fuera del proceso.
El objeto se usa en las siguientes situaciones:
  • Si planea trabajar con el recurso fuera de FineReader Engine
Puede obtener el handle del recurso mediante la propiedad Handle y trabajar con él. En este caso, si libera el objeto Handle, el recurso también se libera. O bien, puede obtener el handle y desacoplar de él el objeto Handle (use el método Detach). En este caso, usted es responsable de liberar el recurso.
  • Si planea pasar el recurso a otros métodos de FineReader Engine
Puede obtener el handle del recurso como __int64 mediante la propiedad HandleAsInt64. Después, puede pasar el valor de esta propiedad a un método de FineReader Engine que lo requiera. Si libera el objeto Handle, el recurso también se libera. Puede liberar el recurso manualmente llamando al método CloseHandle.

Propiedades

NameTipoDescripción
ApplicationEngine, de solo lecturaDevuelve el objeto Engine.
HandleHANDLE*, de solo lecturaDevuelve el handle del recurso. Puede obtener el handle mediante esta propiedad y usar el recurso.
HandleAsInt64__int64, de solo lecturaDevuelve el handle del recurso como __int64. Puede pasar el valor devuelto de esta propiedad a un método de FineReader Engine como parámetro de entrada.

Métodos

NombreDescripción
CloseHandleLibera el recurso.
DetachDevuelve el handle y separa el objeto de él.

Parámetro de salida

Este objeto es el parámetro de salida de los siguientes métodos:

Ejemplos

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// Suponemos que el documento ya se ha creado y que se le han añadido imágenes
// Obtenga el handle del mapa de bits de un plano de imagen en color de una página del documento
FREngine.IFRPage page = frDoc.Pages[0];
FREngine.IImageDocument imageDoc = page.ImageDocument;
FREngine.IImage image = imageDoc.ColorImage;
FREngine.IHandle hBitmap = image.GetBitmap( null );
// Trabaje con el mapa de bits
System.Drawing.IImage preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
...
Gdi32.DeleteObject( hBitmap );
El objeto se utiliza en las siguientes herramientas de demostración de Windows: Perfiles de procesamiento predefinidos del motor.

Consulte también

Uso de Propiedades