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

# Region-Objekt (IRegion-Schnittstelle)

> Region-Objekt (IRegion-Schnittstelle) in der ABBYY FineReader Engine API — zusätzliches Objekt zum Speichern der Region eines FineReader Engine-Blocks als Menge nicht überlappender Rectangles in der Reihenfolge von links nach rechts oder von oben nach unten.

Dies ist ein zusätzliches Objekt. Es dient zum Speichern von Informationen über die Region eines Blocks in ABBYY FineReader Engine.

Eine Region wird als eine Menge von Rectangles dargestellt:

* ohne Schnittpunkte oder Überlappungen positioniert
* in der Reihenfolge von links nach rechts oder von oben nach unten hinzugefügt

Im Folgenden sind einige Beispiele für Regionen in ABBYY FineReader Engine dargestellt:

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/regions.gif?s=b31b3c08fd5e02f80c97328a773e2937" alt="Regions" width="441" height="284" data-path="images/fine-reader/engine/regions.gif" />

Ein leeres Region-Objekt kann durch Aufrufen der Methode [IEngine::CreateRegion](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) erstellt werden; anschließend können ihm durch Aufrufen der Methode [IRegion::AddRect](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addrect-method) Rectangles einzeln hinzugefügt werden. Wir empfehlen, Rectangles in der Reihenfolge von oben nach unten (oder von links nach rechts) hinzuzufügen, da das Region-Objekt dafür optimiert ist und dies die schnellste Möglichkeit ist, Rectangles hinzuzufügen.

Das Region-Objekt ist ein persistentes Objekt. Das bedeutet, dass der aktuelle Zustand des Objekts in einem persistenten Speicher abgelegt werden kann. Später kann das Objekt neu erstellt werden, indem sein Zustand aus dem persistenten Speicher gelesen wird. Die folgenden Methoden ermöglichen die Persistenz des Objekts:

Linux: [SaveToFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) und [LoadFromFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows [SaveToFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) und [LoadFromMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).

<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.                                               |
| [Bottom](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/bottom-property) | [int](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), nur lesbar                                                                                                                   | Gibt die Koordinate der unteren Begrenzung des angegebenen Rectangle zurück. |
| BoundingRectangle                                                                                       | [FRRectangle](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle), [nur lesbar](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Gibt das kleinste Rectangle zurück, das die gesamte Region enthält.          |
| Count                                                                                                   | [int](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), nur lesbar                                                                                                                   | Enthält die Anzahl der Rectangles in der Region.                             |
| IsEmpty                                                                                                 | [VARIANT\_BOOL](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), nur lesbar                                                                                                         | Gibt an, ob die Region leer ist.                                             |
| [Left](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/left-property)     | [int](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), nur lesbar                                                                                                                   | Gibt die Koordinate der linken Begrenzung des angegebenen Rectangle zurück.  |
| [Right](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/right-property)   | [int](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), nur lesbar                                                                                                                   | Gibt die Koordinate der rechten Begrenzung des angegebenen Rectangle zurück. |
| [Top](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/top-property)       | [int](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), nur lesbar                                                                                                                   | Gibt die Koordinate der oberen Begrenzung des angegebenen Rectangle zurück.  |

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

| Name                                                                                                                                                    | Beschreibung                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| [AddRect](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addrect-method)                                                 | Fügt der Region einen Bereich hinzu.                                                                                         |
| [AddRegion](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addregion-method)                                             | Fügt einer vorhandenen Region einen neuen Bereich hinzu.                                                                     |
| [CopyFrom](/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                                | Initialisiert die Eigenschaften des aktuellen Objekts mit den Werten der entsprechenden Eigenschaften eines anderen Objekts. |
| [CutRect](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/cutrect-method)                                                 | Schneidet einen rechteckigen Bereich aus einer Region aus.                                                                   |
| [HasIntersectionWithRect](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/hasintersectionwithrect-method)                 | Ermittelt, ob sich die Region mit dem angegebenen Rectangle überschneidet.                                                   |
| [HasIntersectionWithRegion](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/hasintersectionwithregion-method)             | Ermittelt, ob sich die Region mit der angegebenen Region überschneidet.                                                      |
| [IsEqual](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isequal-method)                                                 | Ermittelt, ob die Region mit der angegebenen Region identisch ist.                                                           |
| [IsPointInRegion](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/ispointinregion-method)                                 | Ermittelt, ob sich der angegebene Point innerhalb der Region befindet.                                                       |
| [IsRectInRegion](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isrectinregion-method)                                   | Ermittelt, ob das angegebene Rectangle in der Region enthalten ist.                                                          |
| [IsRegionInRegion](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isregioninregion-method)                               | Ermittelt, ob die angegebene Region in der Region enthalten ist.                                                             |
| [LoadFromFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                              | Stellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.                                                |
| [LoadFromMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **Hinweis:** *Nur Windows.* | Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her.                                                          |
| [MakeEmpty](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/makeempty-method)                                             | Entfernt alle Rectangles aus der Region.                                                                                     |
| [SaveToFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                                  | Speichert den Inhalt des Objekts in einer Datei auf dem Datenträger.                                                         |
| [SaveToMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **Hinweis:** *Nur Windows.*     | Speichert den Inhalt des Objekts im globalen Speicher.                                                                       |

<div id="related-objects">
  ## Zugehörige Objekte
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/region.gif?s=7ec0a7f856b5518a3ae6334ac4ce57d3" alt="Region" width="307" height="214" data-path="images/fine-reader/engine/region.gif" />[](/de/fine-reader/engine/api-reference/document-comparison-objects/changelocation/regionforpage-property)[](/de/fine-reader/engine/api-reference/document-comparison-objects/changelocation)[](/de/fine-reader/engine/api-reference/document-related-objects/mrzfield)[](/de/fine-reader/engine/api-reference/document-related-objects/mrzline)[](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/splitregion#sourceregion)[](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle)[](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/splitregion)[](/de/fine-reader/engine/api-reference/document-related-objects/businesscard)[](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/regionscollection)[](/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/de/fine-reader/engine/api-reference/text-related-objects/charparams#characterregion)[](/de/fine-reader/engine/api-reference/text-related-objects/charparams)[](/de/fine-reader/engine/api-reference/layout-related-objects/block#region)[](/de/fine-reader/engine/api-reference/layout-related-objects/block)[](/de/fine-reader/engine/api-reference/text-related-objects/word)

[Objektdiagramm](/de/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## Output-Parameter
</div>

Dieses Objekt ist der Output-Parameter der Methode [CreateRegion](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) des Objekts [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface).

<div id="input-parameter">
  ## Eingabeparameter
</div>

Dieses Objekt wird als Eingabeparameter an die folgenden Methoden übergeben:

* [AnalyzeRegion](/de/fine-reader/engine/api-reference/document-related-objects/frpage/analyzeregion-method), [SynthesizeBusinessCard](/de/fine-reader/engine/api-reference/document-related-objects/frpage/synthesizebusinesscard-method), [SynthesizeBusinessCardEx](/de/fine-reader/engine/api-reference/document-related-objects/frpage/synthesizebusinesscardex-method) Methoden des [FRPage](/de/fine-reader/engine/api-reference/document-related-objects/frpage)-Objekts
* [RemoveColorObjects](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/removecolorobjects-method), [RemoveMotionBlur](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/removemotionblur-method), [RemoveGarbage](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/removegarbage-method), [SmoothImage](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/smoothimage-method), [SaveImageRegionTo](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/saveimageregionto-method) Methoden des [ImageDocument](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument)-Objekts
* [AddNew](/de/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup/addnew-method) Methode des [CheckmarkGroup](/de/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup)-Objekts
* [AddNew](/de/fine-reader/engine/api-reference/layout-related-objects/separatorgroup/addnew-method) Methode des [SeparatorGroup](/de/fine-reader/engine/api-reference/layout-related-objects/separatorgroup)-Objekts
* [Add](/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/add-method), [InsertAt](/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/insertat-method) Methoden des [RegionsCollection](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/regionscollection)-Objekts
* [SetImageData](/de/fine-reader/engine/api-reference/image-related-objects/trainingimage/setimagedata-method) Methode des [TrainingImage](/de/fine-reader/engine/api-reference/image-related-objects/trainingimage)-Objekts
* [AddClipRegion](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification/addclipregion-method), [AddInvertRegion](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification/addinvertregion-method), [AddPaintRegion](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification/addpaintregion-method), [AddReplaceBlackPixelsRegion](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification/addreplaceblackpixelsregion-method), [AddReplaceWhitePixelsRegion](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification/addreplacewhitepixelsregion-method) Methoden des [ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification)-Objekts
* Für Windows Visual Components:
  * [OnAnalyzeRegion](/de/fine-reader/engine/visual-components-reference/iimageviewerevents/onanalyzeregion-method), [OnToolChangeBlockRegion](/de/fine-reader/engine/visual-components-reference/iimageviewerevents/ontoolchangeblockregion-method) Methoden der [IImageViewerEvents](/de/fine-reader/engine/visual-components-reference/iimageviewerevents)-Schnittstelle
  * [OnAnalyzeRegion](/de/fine-reader/engine/visual-components-reference/izoomviewerevents/onanalyzeregion-method), [OnToolChangeBlockRegion](/de/fine-reader/engine/visual-components-reference/izoomviewerevents/ontoolchangeblockregion-method) Methoden der [IZoomViewerEvents](/de/fine-reader/engine/visual-components-reference/izoomviewerevents)-Schnittstelle

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

Dieses Objekt wird im [Codebeispiel zur Visitenkartenerkennung](/de/fine-reader/engine/guided-tour/samples#bcr_mac) (macOS) verwendet.

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

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