Passer au contenu principal
Cet objet permet d’accéder à la poignée d’une ressource en mémoire. Il est renvoyé par certaines méthodes qui donnent accès à une image bitmap ou à un bloc de mémoire. Cet objet gère l’allocation de mémoire et vous permet d’éviter les fuites de mémoire lors du travail avec ces ressources.
Cette interface ne prend pas en charge l’automatisation. Cela signifie qu’elle ne fonctionne pas sous Linux et Windows si FineReader Engine est chargé en tant que serveur hors processus.
L’objet est utilisé dans les situations suivantes :
  • Si vous prévoyez de travailler avec la ressource en dehors de FineReader Engine
Vous pouvez obtenir la poignée de la ressource via la propriété Handle et travailler avec elle. Dans ce cas, si vous libérez l’objet Handle, la ressource est également libérée. Ou vous pouvez obtenir la poignée et détacher l’objet Handle de celle-ci (utilisez la méthode Detach). Dans ce cas, vous êtes responsable de la libération de la ressource.
  • Si vous prévoyez de passer la ressource à d’autres méthodes de FineReader Engine
Vous pouvez obtenir la poignée de la ressource sous forme de __int64 via la propriété HandleAsInt64. Plus tard, vous pouvez passer la valeur de cette propriété à une méthode de FineReader Engine qui l’exige. Si vous libérez l’objet Handle, la ressource est également libérée. Vous pouvez libérer la ressource manuellement en appelant la méthode CloseHandle.

Propriétés

NomTypeDescription
ApplicationEngine, lecture seuleRetourne l’objet Engine.
HandleHANDLE*, lecture seuleRetourne la poignée de la ressource. Vous pouvez obtenir la poignée via cette propriété et travailler avec la ressource.
HandleAsInt64__int64, lecture seuleRetourne la poignée de la ressource sous forme de __int64. Vous pouvez passer la valeur de retour de cette propriété à une méthode de FineReader Engine en tant que paramètre d’entrée.

Méthodes

NomDescription
CloseHandleLibère la ressource.
DetachRetourne la poignée et détache l’objet de celle-ci.

Paramètre de sortie

Cet objet est le paramètre de sortie des méthodes suivantes :

Exemples

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// Nous supposons que le document a été créé et que des images y ont été ajoutées
// Obtenir le handle bitmap d'un plan d'image couleur d'une page de document
FREngine.IFRPage page = frDoc.Pages[0];
FREngine.IImageDocument imageDoc = page.ImageDocument;
FREngine.IImage image = imageDoc.ColorImage;
FREngine.IHandle hBitmap = image.GetBitmap( null );
// Utilisation du bitmap
System.Drawing.IImage preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
...
Gdi32.DeleteObject( hBitmap );
L’objet est utilisé dans les outils de démonstration Windows suivants : Engine Predefined Processing Profiles.

Voir aussi

Travailler avec les propriétés