> ## 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.

# Handle-Objekt (IHandle-Schnittstelle)

> Handle-Objekt (IHandle-Schnittstelle) in der ABBYY FineReader Engine API — Bietet Zugriff auf das Handle einer Ressource im Speicher (Bitmap oder Speicherblock), verwaltet die Speicherzuweisung und vermeidet Speicherlecks; nicht als Out-of-Process-Server verfügbar.

Dieses Objekt bietet Zugriff auf das Handle einer Ressource im Speicher. Es wird von einigen Methoden zurückgegeben, die Zugriff auf eine Bitmap oder einen Speicherblock ermöglichen. Das Objekt verwaltet die Speicherzuweisung und hilft Ihnen, Speicherlecks bei der Arbeit mit diesen Ressourcen zu vermeiden.

<Warning>
  Diese Schnittstelle unterstützt keine Automatisierung. Das bedeutet, dass sie unter Linux und Windows nicht funktioniert, wenn FineReader Engine als Out-of-Process-Server geladen wird.
</Warning>

Das Objekt wird in den folgenden Situationen verwendet:

* Wenn Sie mit der Ressource außerhalb von FineReader Engine arbeiten möchten

Sie können das Handle der Ressource über die Eigenschaft Handle abrufen und damit arbeiten. In diesem Fall wird die Ressource ebenfalls freigegeben, wenn Sie das Handle-Objekt freigeben. Oder Sie können das Handle abrufen und das Handle-Objekt davon trennen (verwenden Sie dazu die Methode Detach). In diesem Fall sind Sie selbst für die Freigabe der Ressource verantwortlich.

* Wenn Sie die Ressource an andere Methoden von FineReader Engine übergeben möchten

Sie können das Handle der Ressource über die Eigenschaft HandleAsInt64 als \_\_int64 abrufen. Später können Sie den Wert dieser Eigenschaft an eine Methode von FineReader Engine übergeben, die ihn benötigt. Wenn Sie das Handle-Objekt freigeben, wird die Ressource ebenfalls freigegeben. Sie können die Ressource auch manuell freigeben, indem Sie die Methode CloseHandle aufrufen.

<div id="properties">
  ## Eigenschaften
</div>

| Name          | Typ                                                                                                                                                                                                                  | Beschreibung                                                                                                                                                                                                                                                                   |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Application   | [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface), [nur lesbar](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Gibt das Engine-Objekt zurück.                                                                                                                                                                                                                                                 |
| Handle        | [HANDLE\*](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), nur lesbar                                                                                           | Gibt das Handle der Ressource zurück. Sie können das Handle über diese Eigenschaft abrufen und mit der Ressource arbeiten.                                                                                                                                                     |
| HandleAsInt64 | [\_\_int64](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), nur lesbar                                                                                          | Gibt das Handle der Ressource als [\_\_int64](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties) zurück. Sie können den Rückgabewert dieser Eigenschaft als Eingabeparameter an eine Methode der FineReader Engine übergeben. |

<div id="methods">
  ## Methoden
</div>

| Name                                                                                                            | Beschreibung                                      |
| --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| [CloseHandle](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle/closehandle-method) | Gibt die Ressource frei.                          |
| [Detach](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle/detach-method)           | Gibt das Handle zurück und löst das Objekt davon. |

<div id="output-parameter">
  ## Ausgabeparameter
</div>

Dieses Objekt ist der Ausgabeparameter der folgenden Methoden:

* [GetBitmap](/de/fine-reader/engine/api-reference/image-related-objects/image/getbitmap-method)-Methode des [Image](/de/fine-reader/engine/api-reference/image-related-objects/image)-Objekts
* [SaveToMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)-Methode mehrerer Objekte (Windows)

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

<Accordion title="C#-Code">
  ```csharp theme={null}
  FREngine.IEngine engine;
  FREngine.IFRDocument frdoc;
  // Es wird davon ausgegangen, dass das Dokument erstellt wurde und ihm Bilder hinzugefügt wurden
  // Bitmap-Handle einer Farbabbildung einer Dokumentseite abrufen
  FREngine.IFRPage page = frDoc.Pages[0];
  FREngine.IImageDocument imageDoc = page.ImageDocument;
  FREngine.IImage image = imageDoc.ColorImage;
  FREngine.IHandle hBitmap = image.GetBitmap( null );
  // Mit der Bitmap arbeiten
  System.Drawing.IImage preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
  ...
  Gdi32.DeleteObject( hBitmap );
  ```
</Accordion>

Das Objekt wird in den folgenden Windows-Demotools verwendet: [Engine Predefined Processing Profiles](/de/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles).

<div id="see-also">
  ## Siehe auch
</div>

[Arbeiten mit Eigenschaften](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)