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

# Suchbereich

> Suchbereiche geben in einem FlexiLayout vor, wo nach Objekten gesucht werden soll – mithilfe absoluter Koordinaten oder Relationen zu anderen Elementen, Versätzen und der Eigenschaft Nearest.

Ein **Suchbereich** wird durch eine Menge von Suchbedingungen und Relationen definiert. Er gibt dem Programm vor, wo es nach den durch die Elemente beschriebenen Objekten suchen soll.

Suchbereiche bestehen aus einem oder mehreren Rechtecken, die keine gemeinsamen Grenzen haben müssen, das heißt, Suchbereiche können diskontinuierlich sein.

Ein Suchbereich kann durch absolute Suchbedingungen, das heißt durch Koordinaten, oder durch relative Suchbedingungen, das heißt durch Relationen zu anderen Elementen, definiert werden.

Bei der Angabe relativer Suchbedingungen können Sie beliebige Elemente verwenden, die sich oberhalb des beschriebenen Elements im FlexiLayout-Baum befinden (das diesem Element entsprechende Bildobjekt kann nur mithilfe von Informationen über die bereits gefundenen Objekte ermittelt werden, die durch die im Baum weiter oben stehenden Elemente beschrieben werden).

<div id="specify-the-absolute-coordinates-of-a-search-area">
  ## Geben Sie die absoluten Koordinaten eines Suchbereichs an
</div>

Ein absoluter Suchbereich wird auf der Registerkarte **Suchbedingungen** im Dialogfeld **Properties** des Elements definiert.

Für mehrseitige Dokumente können Sie einen Seitenbereich auswählen, in dem nach einem Element gesucht werden soll. Sie können die absoluten lokalen Koordinaten eines Suchbereichs über die Eigenschaft **Region** festlegen.

<div id="exclude-an-element-from-the-search-area">
  ## Ausschließen eines Elements aus dem Suchbereich
</div>

Mit der Eigenschaft **Exclude regions of elements** können Sie die Region der gefundenen Hypothese eines Elements aus dem Suchbereich ausschließen. Wird keine Hypothese des ausgeschlossenen Elements gefunden, hat diese Einschränkung keine Auswirkungen auf den Suchbereich des Elements.

<Note>
  Eine Ausnahme tritt auf, wenn im Bereich **Advanced pre-search relations** zusätzliche Einschränkungen für einige der Begrenzungen der Hypothese des ausgeschlossenen Elements angegeben sind. Wird das ausgeschlossene Element in diesem Fall nicht gefunden, schneidet FlexiLayout Studio den rechteckigen Suchbereich dieses Elements aus dem umgebenden Suchbereich aus. Weitere Informationen zu internen Rechtecken finden Sie unter [Fuzzy rectangle](/de/flexi-capture/fls/language/fuzzy-rect).
</Note>

<div id="recognize-vertical-text">
  ## Vertikalen Text erkennen
</div>

Für die Elemente **Currency**, **Datum**, **Telefon**, **Zeichenkette**, **Statischer Text** und **Absatz** steht die Option **Search through vertical text** zur Verfügung, die sowohl horizontal als auch vertikal ausgerichteten Text erkennt. Mit den Optionen **Clockwise oriented** und **Counterclockwise oriented** wird die Erkennung von vertikalem Text von oben nach unten bzw. von unten nach oben aktiviert oder deaktiviert. Diese Optionen sind standardmäßig aktiviert und können nur deaktiviert werden, wenn **Search through vertical text** ausgewählt ist.

<div id="specify-a-search-area-relative-to-another-element">
  ## Geben Sie einen Suchbereich relativ zu einem anderen Element an
</div>

Ein relativer Suchbereich wird auf der Registerkarte **Relations** im Dialogfeld **Properties** des Elements definiert. Um einen relativen Suchbereich zu definieren, geben Sie ein Referenzelement an, relativ zu dem die Grenzen festgelegt werden, und definieren Sie Relationen vom Typ **Right of**, **Left of**, **Above** und **Below** (Eigenschaft **Relations**).

Sie können für jedes Element eine beliebige Anzahl von Suchbereichen angeben. Die Grenzen eines Suchbereichs können relativ zu unterschiedlichen Referenzelementen festgelegt werden. Wenn kein relativer Suchbereich angegeben wurde, sucht das Programm im gesamten Bild nach dem Objekt.

Jede der Suchbedingungen definiert eine Halbebene. Der Schnitt der Halbebene mit dem Bild ergibt einen rechteckigen Teil des Suchbereichs. Der Schnitt aller Suchbedingungen mit dem Bild ergibt den Suchbereich eines Elements.

Die Grenzen eines Suchbereichs können mithilfe der Eigenschaften **Element boundary** und **Versatz** genauer festgelegt werden.

<div id="the-element-boundary-property">
  ### Die Eigenschaft Element boundary
</div>

Die Eigenschaft **Element boundary** gibt eine Begrenzung eines Suchbereichs relativ zur oberen, unteren, linken oder rechten Begrenzung eines Elements an. Standardmäßig ist diese Eigenschaft auf `<whole>` gesetzt.

Bei der Berechnung eines relativen Suchbereichs kann FlexiLayout Studio das in der Eigenschaft **Referenzelement** angegebene Referenzelement möglicherweise nicht finden. Die Berechnung fällt daher unterschiedlich aus, je nachdem, ob das Referenzelement gefunden wird.

Wenn das Referenzelement optional ist und keine Objekte im Bild die im Element angegebenen Bedingungen erfüllen, wird eine Nullhypothese formuliert. Die Region dieser Nullhypothese entspricht dem Rechteck, das den Suchbereich des Elements umschließt.

Wird das Referenzelement gefunden, wird die Region der Hypothese aus den Regionen der erkannten Objekte gebildet, die an der Hypothese beteiligt sind, und liegt innerhalb des Suchbereichs des Elements.

Wenn das Referenzelement gefunden wird und **Element boundary** auf `<whole>` gesetzt ist, bedeutet eine Einschränkung **Right of** „rechts von der rechten Begrenzung des Referenzelements“, eine Einschränkung **Left of** bedeutet „links von der linken Begrenzung des Referenzelements“ und so weiter (also relativ zur Hypothese).

Wenn keine Hypothese für das Referenzelement formuliert wird, kann sich das Element an jeder Stelle im Suchbereich des Referenzelements befinden, jedoch nicht außerhalb davon.

In diesem Fall bedeutet eine Einschränkung **Right of** „rechts von jedem Bereich, in dem sich die Hypothesen für das Referenzelement befinden könnten“. Mathematisch bedeutet dies „rechts von der linken Begrenzung des Suchbereichs des Referenzelements“. Entsprechend bedeutet eine Einschränkung **Left of** „links von der rechten Begrenzung“, eine Einschränkung **Below** „unterhalb der oberen Begrenzung“ und eine Einschränkung **Above** „oberhalb der unteren Begrenzung“.

Wenn **Element boundary** auf einen bestimmten Wert (**Left**, **Top**, **Right** oder **Bottom**) gesetzt ist, wird der Suchbereich relativ zu dieser Begrenzung der Hypothese des Referenzelements berechnet, unabhängig davon, ob die Hypothese gefunden wurde oder nicht. Bei einer nicht gefundenen Hypothese bedeutet zum Beispiel eine Einschränkung **Right of** mit **Element boundary** = **Right** „rechts von der rechten Begrenzung des Suchbereichs des Referenzelements“.

<div id="the-offset-property">
  ### Die Eigenschaft Versatz
</div>

Die Eigenschaft **Versatz** verschiebt eine Grenze des Suchbereichs um eine bestimmte Distanz. Ein positiver **Versatz**-Wert verschiebt die Grenze in dieselbe Richtung, die durch die Eigenschaft **Relation** angegeben ist. Ein negativer **Versatz**-Wert verschiebt die Grenze in die entgegengesetzte Richtung.

Ein FlexiLayout enthält beispielsweise ein Element **YourPlanetName** vom Typ **Static Text**, das im Bild den Feldnamen YOUR PLANET NAME: findet. Ziel ist es, den in dieses Feld eingegebenen Text zu finden (in diesem Fall „MARS (satellite Phobos)“).

Erstellen Sie ein Element **Planet** vom Typ **Zeichenkette** und geben Sie einen Suchbereich an, der sich rechts vom Element **YourPlanetName** befindet. Setzen Sie dazu die Eigenschaft **Element boundary** auf **Right of**. Die folgende Abbildung zeigt die Position des Suchbereichs:

<Frame>
  <img src="https://mintcdn.com/abbyy/lqYknuOmCa79141v/images/flexi-capture/fls/SearchArea_I.gif?s=dccbc554db58e2b83a577c8dfbce23f2" alt="Diagramm des Suchbereichs rechts vom Element YourPlanetName" width="290" height="27" data-path="images/flexi-capture/fls/SearchArea_I.gif" />
</Frame>

Verschieben Sie die Grenze des Suchbereichs nach rechts, also in dieselbe Richtung wie die Relation **Right of**. Wählen Sie dazu einen positiven **Versatz**-Wert, zum Beispiel 200. Die folgende Abbildung zeigt die neue Position der Grenze:

<Frame>
  <img src="https://mintcdn.com/abbyy/lqYknuOmCa79141v/images/flexi-capture/fls/SearchArea_II.gif?s=468f7adfa95f3d90fb1f2bc998decfbd" alt="Diagramm der Suchbereichsgrenze, die durch einen positiven Versatz-Wert nach rechts verschoben wurde" width="299" height="37" data-path="images/flexi-capture/fls/SearchArea_II.gif" />
</Frame>

Verschieben Sie nun die Grenze des Suchbereichs nach links, also in die der Relation **Right of** entgegengesetzte Richtung. Wählen Sie dazu einen negativen **Versatz**-Wert, zum Beispiel -200. Die folgende Abbildung zeigt die neue Position der Grenze:

<Frame>
  <img src="https://mintcdn.com/abbyy/lqYknuOmCa79141v/images/flexi-capture/fls/SearchArea_III.gif?s=b06c160ef3ebe156d928f735dc447ba6" alt="Diagramm der Suchbereichsgrenze, die durch einen negativen Versatz-Wert nach links verschoben wurde" width="306" height="39" data-path="images/flexi-capture/fls/SearchArea_III.gif" />
</Frame>

<div id="select-the-element-located-closest-to-a-certain-object">
  ## Wählen Sie das Element aus, das sich am nächsten bei einem bestimmten Objekt befindet
</div>

Die Eigenschaft **Nearest** teilt FlexiLayout Studio mit, dass es — wenn alle anderen Bedingungen gleich sind — nach einer Hypothese suchen muss, die einem bestimmten Element oder Punkt im Bild am nächsten liegt. Geben Sie in der Eigenschaft **Nearest** des Elements das nächstgelegene Element, den nächstgelegenen Punkt oder die Koordinatenachse an.

<div id="view-a-search-area">
  ## Einen Suchbereich anzeigen
</div>

Wenn Sie Beziehungseigenschaften bearbeiten oder eine Beziehung in der Tabelle **Relations** auswählen, wird die Beziehung im **Bildfenster** visualisiert. Wenn Sie mehrere Beziehungen auswählen, wird ihre Schnittmenge angezeigt. Im Modus **Reference layout** können Sie die Versatzgrenze auch direkt im Bildfenster mit der Maus ziehen, um den Versatzwert zu ändern.

Beim Abgleich eines FlexiLayouts berechnet FlexiLayout Studio zunächst den Suchbereich des Elements anhand aller angegebenen Einschränkungen. Anschließend prüft das Programm, ob die Bildobjekte im Suchbereich dieselben Eigenschaften wie die Elemente aufweisen.

Wenn beim Abgleich des FlexiLayouts das falsche Objekt gefunden wird, können Sie anhand des Suchbereichs des Elements erkennen, warum.

Um den Suchbereich eines Elements nach dem Abgleich eines FlexiLayouts anzuzeigen, klicken Sie mit der rechten Maustaste auf die Hypothese, die dem Element entspricht, und wählen Sie im Kontextmenü **Suchbereich anzeigen** aus. Der Suchbereich wird im **Bildfenster** angezeigt.

<div id="related-topics">
  ## Verwandte Themen
</div>

* [Suchbedingungen](/de/flexi-capture/fls/template/basic-constraints)
* [Relativer Suchbereich](/de/flexi-capture/fls/template/relations)
* [Instanzen einer wiederholbaren Gruppe als Referenz-, Ausschluss- oder Source-Elemente verwenden](/de/flexi-capture/fls/template/select-repeatable-group)
* [Zusätzliche Suchbedingungen](/de/flexi-capture/fls/template/advanced-constraints)
