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

# GetBitmap-Methode des Image-Objekts

> GetBitmap-Methode des Image-Objekts in der ABBYY FineReader Engine API — Gibt einen Teil des Bildes als Top-down-DIB (Device-Independent Bitmap) über ein Handle-Objekt zurück, das die Speicherfreigabe verwaltet (nur unter Windows).

<Warning>
  Diese Methode ist in FRE für Windows implementiert.
</Warning>

Diese Methode gibt einen Teil des Bildes als Top-down-DIB (Device-Independent Bitmap) zurück. Für Graustufen- und Schwarzweißbilder wird eine Palette verwendet, bei der 0 der Farbe Schwarz entspricht.

Die Methode gibt das DIB als [Handle](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle)-Objekt zurück. Dieses Objekt verwaltet die Speicherbelegung und gibt Ressourcen frei, wenn sie nicht mehr verwendet werden.

<div id="syntax">
  ## Syntax
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT GetBitmap(
  IImageModification* Modification,
  IHandle**           Result
);
```

### C\#

```csharp theme={null}
IHandle GetBitmap( IImageModification Modification );
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Function GetBitmap(Modification As IImageModification) As IHandle
```

<div id="parameters">
  ## Parameter
</div>

Modification

\[in] Dieser Parameter vom Typ [ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification) definiert die Änderungen, die am Bild vorgenommen werden. Er kann Zuschneiderechtecke enthalten; in diesem Fall werden nur die angegebenen Teile des Bildes übergeben, außerdem ein Streckungsverhältnis, Füllrechtecke zum Füllen von Bildbereichen mit Farbe und so weiter. Dieser Parameter kann 0 sein; in diesem Fall werden keine Änderungen an der Bildseite vorgenommen und sie wird „wie besehen“ übergeben.

Result

\[out, retval] Ein Zeiger auf eine IHandle\*-Zeigervariable, die den Schnittstellenzeiger des resultierenden [Handle](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle)-Objekts erhält, das das Handle für die zugeordnete Bitmap darstellt.

<div id="return-values">
  ## Rückgabewerte
</div>

* Windows: Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die [standardmäßigen Rückgabewerte von ABBYY FineReader Engine-Funktionen](/de/fine-reader/engine/api-reference/return-codes) zurück.

* Linux und macOS: Diese Methode gibt E\_NOTIMPL zurück.

<div id="remarks">
  ## Hinweise
</div>

Diese Methode funktioniert nicht, wenn die Engine unter Linux als Out-of-Process-Server geladen wird oder wenn das Objekt unter Windows über das Objekt [OutprocLoader](/de/fine-reader/engine/api-reference/engine-loaders/outprocloader) erstellt wird.

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

<Accordion title="C#-Code">
  ```csharp theme={null}
  FREngine.IEngine engine;
  FREngine.IFRDocument frdoc;
  // Wir setzen voraus, dass das Dokument erstellt und ihm Bilder hinzugefügt wurden
  // Bitmap-Handle einer Farbbildebene 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.Image preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
  ...
  Gdi32.DeleteObject( hBitmap );
  ```
</Accordion>

Die Methode 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>

[ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification)

[IImage::EstimateBitmapSize](/de/fine-reader/engine/api-reference/image-related-objects/image/estimatebitmapsize-method)