> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Objet Handle (Interface IHandle)

> Objet Handle (interface IHandle) dans l’API ABBYY FineReader Engine — permet d’accéder au handle d’une ressource en mémoire (bitmap ou bloc mémoire), gère l’allocation de mémoire et évite les fuites ; non disponible hors processus.

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.

<Warning>
  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.
</Warning>

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.

<div id="properties">
  ## Propriétés
</div>

| Nom           | Type                                                                                                                                                                                                                    | Description                                                                                                                                                                                                                                                                                     |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Application   | [Engine](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface), [lecture seule](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Retourne l’objet Engine.                                                                                                                                                                                                                                                                        |
| Handle        | [HANDLE\*](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), lecture seule                                                                                           | Retourne la poignée de la ressource. Vous pouvez obtenir la poignée via cette propriété et travailler avec la ressource.                                                                                                                                                                        |
| HandleAsInt64 | [\_\_int64](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), lecture seule                                                                                          | Retourne la poignée de la ressource sous forme de [\_\_int64](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties). 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. |

<div id="methods">
  ## Méthodes
</div>

| Nom                                                                                                             | Description                                         |
| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| [CloseHandle](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle/closehandle-method) | Libère la ressource.                                |
| [Detach](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle/detach-method)           | Retourne la poignée et détache l'objet de celle-ci. |

<div id="output-parameter">
  ## Paramètre de sortie
</div>

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

* Méthode [GetBitmap](/fr/fine-reader/engine/api-reference/image-related-objects/image/getbitmap-method) de l'objet [Image](/fr/fine-reader/engine/api-reference/image-related-objects/image)
* Méthode [SaveToMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) de plusieurs objets (Windows)

<div id="samples">
  ## Exemples
</div>

<Accordion title="Code C#">
  ```csharp theme={null}
  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 );
  ```
</Accordion>

L'objet est utilisé dans les outils de démonstration Windows suivants : [Engine Predefined Processing Profiles](/fr/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles).

<div id="see-also">
  ## Voir aussi
</div>

[Travailler avec les propriétés](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)