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

# Funktionen zur Einschränkung des Suchbereichs

> Begrenzen Sie die Suchbereiche von Elementen in den erweiterten Beziehungen für die Vorabsuche von FlexiLayout mit den Funktionen LeftOf, RightOf, Above, Below, Exclude und RestrictSearchArea.

Die in der folgenden Tabelle aufgeführten Funktionen können nur im Abschnitt **Erweiterte Beziehungen für die Vorabsuche** verwendet werden. Jede Funktion definiert entweder ein Fuzzy Rectangle für den Suchbereich oder fügt einem Array ausgeschlossener Rechtecke Rechtecke hinzu.

<table width="100%">
  <tbody>
    <tr>
      <td>
        <p>
          <strong>Funktion</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Beschreibung</strong>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Leftof( XInterval x, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf ein Rechteck, das sich aus dem Schnitt des Seitenrechtecks mit der vertikalen Halbebene links vom Punkt x.End - offset ergibt.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Leftof( FuzzyRect fuzzyRect, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf die vertikale Halbebene links des Punkts fuzzyRect.Left.End – offset.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Leftof( Hypothesis hyp, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf ein Rechteck, das sich aus der Schnittmenge des Seitenrechtecks mit der vertikalen Halbebene links des Punkts hyp.Left.End - offset ergibt.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void LeftOf( HypothesisInstances hyps, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf die vertikale Halbebene links vom Punkt hyps.Left.End – offset. Es werden globale Koordinaten verwendet.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Rightof( XInterval x, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf ein Rechteck, das sich aus dem Schnitt des Rechtecks der Seite mit der vertikalen Halbebene rechts vom Punkt x.Start + offset ergibt.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Rightof( FuzzyRect fuzzyRect, Distance offset = 0 )</p>
      </td>

      <td>
        <details>
          <summary>z. B.</summary>
          <p>Sie können angeben, dass sich der Suchbereich des Elements rechts von dem Schnittbereich befindet, der von den Fuzzy-Rectangles Element1 und Element2 gebildet wird.</p>

          <pre>
            <code>FuzzyRect intersection = Element1.FuzzyRect AND Element2.FuzzyRect; RightOf: intersection;</code>
          </pre>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Rightof( Hypothesis hyp, Distance offset = 0 )</p>
      </td>

      <td>
        <p>
          Begrenzt den Suchbereich auf ein Rechteck, das sich aus dem Schnitt des Seitenrechtecks mit der vertikalen Halbebene rechts des Punkts hyp.Right.Start + offset ergibt.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RightOf( HypothesisInstances hyps, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf die vertikale Halbebene rechts des Punkts hyp.Right.Start + offset. Es werden globale Koordinaten verwendet.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Above( YInterval y, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf ein Rechteck, das sich aus dem Schnitt des Seitenrechtecks mit der horizontalen Halbebene oberhalb des Punkts y.End - offset ergibt.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Above( FuzzyRect fuzzyRect, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf die horizontale Halbebene oberhalb des Punkts hyp.top.End – offset.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Above( Hypothesis hyp, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf ein Rechteck, das sich aus der Schnittmenge des Seitenrechtecks mit der horizontalen Halbebene oberhalb des Punkts hyp.top.End - offset ergibt.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Above( HypothesisInstances hyps, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf die horizontale Halbebene oberhalb des Punkts hyp.top.End – offset. Es werden globale Koordinaten verwendet.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Below( YInterval y, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf ein Rechteck, das durch die Schnittmenge des Rechtecks der Seite mit der horizontalen Halbebene entsteht, die unterhalb des Punkts y.Start + offset liegt.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Below( FuzzyRect fuzzyRect, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf die horizontale Halbebene unterhalb des Punkts hyp.Bottom.Start + offset.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Below( Hypothesis hyp, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf ein Rechteck, das sich aus der Schnittmenge des Seitenrechtecks mit der horizontalen Halbebene unterhalb des Punkts hyp.Bottom.Start + offset ergibt.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Below( HypothesisInstances hyps, Distance offset = 0 )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich durch die horizontale Halbebene unterhalb des Punkts hyp.Bottom.Start + offset. Es werden globale Koordinaten verwendet.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Exclude( Hypothesis hyp )</p>
      </td>

      <td>
        <p>Schließt die Region der Hypothese `hyp` aus dem Suchbereich aus. Wenn die Hypothese `hyp` nicht gefunden wird, wird das innere Rechteck des Suchbereichs der Hypothese `hyp` ausgeschlossen.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Exclude( Rect rect )</p>
      </td>

      <td>
        <p>Schließt das Rechteck rect aus dem Suchbereich aus.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Exclude( RectArray rectArray )</p>
      </td>

      <td>
        <p>Schließt das Rechteck-Array rectArray aus dem Suchbereich aus.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void ExcludeRect( XInterval left, YInterval top, XInterval right, YInterval bottom )</p>
      </td>

      <td>
        <p>Schließt das durch die Bereiche left, top, right und bottom beschriebene unscharfe Rechteck aus dem Suchbereich aus.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void ExcludeSet( ImageObjectSet set )</p>
      </td>

      <td>
        <p>
          Schließt das Rechteck-Array des Objekt-Sets <em>set</em> aus dem Suchbereich aus.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Exclude( HypothesisInstances )</p>
      </td>

      <td>
        <p>Schließt die Region der Instanzen der Hypothese vom Suchbereich aus.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RestrictSearchArea( FuzzyRect fuzzyRect )</p>
      </td>

      <td>
        <p>Beschränkt den Suchbereich auf das Fuzzy-Rechteck fuzzyRect. Es werden globale Koordinaten verwendet.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RestrictSearchArea( FuzzyRect, IntArray pages )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich anhand des Fuzzy-Rechtecks fuzzyRect. Geben Sie die lokalen Koordinaten und den Seitenbereich pages an.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RestrictSearchArea( FuzzyRect, SearchAreaPageSetType )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich mithilfe des unscharfen Rechtecks fuzzyRect. Geben Sie die lokalen Koordinaten und den Seitenbereich des Typs SearchAreaPageSetType an.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RestrictSearchArea( RectArray rectArray )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich auf das Rechteck-Array rectArray. Es werden globale Koordinaten verwendet.</p>

        <details>
          <summary>Z. B.</summary>

          <p>
            Sie können festlegen, dass die Grenzen des Suchbereichs des aktuellen Elements durch die Grenzen der Rechtecke der Elemente ElementName1, ElementName2 und ElementName3 definiert werden.
            Falls eines der Elemente nicht erkannt wird, wird bei Verwendung dieser Funktion der Suchbereich des aktuellen Elements durch die Grenzen der Suchbereiche der entsprechenden
            Elemente definiert.
          </p>

          <pre>
            <code>RestrictSearchArea: RectArray(ElementName1.Rect or ElementName2.Rect or ElementName3.Rect);</code>
          </pre>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RestrictSearchArea( RectArray, IntArray pages )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich mithilfe des Rechteck-Arrays rectArray. Geben Sie die lokalen Koordinaten und den Seitenbereich in pages an.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RestrictSearchArea( RectArray, SearchAreaPageSetType )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich mithilfe des Rechteck-Arrays rectArray. Geben Sie die lokalen Koordinaten und den Seitenbereich vom Typ SearchAreaPageSetType an.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RestrictSearchArea( Region region )</p>
      </td>

      <td>
        <p>Beschränkt den Suchbereich auf die Region region. Es werden globale Koordinaten verwendet.</p>

        <details>
          <summary>Z. B.</summary>
          <p>Sie können festlegen, dass der Suchbereich des aktuellen Elements durch die Region des Elements ElementName eingeschränkt wird.</p>

          <pre>
            <code>RestrictSearchArea: ElementName.Region;</code>
          </pre>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RestrictSearchArea( Region, IntArray pages )</p>
      </td>

      <td>
        <p>Beschränkt den Suchbereich auf die Region. Geben Sie die lokalen Koordinaten und den Seitenbereich pages an.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RestrictSearchArea( Region, SearchAreaPageSetType )</p>
      </td>

      <td>
        <p>Begrenzt den Suchbereich mithilfe der Region. Geben Sie die lokalen Koordinaten und den Seitenbereich vom Typ SearchAreaPageSetType an.</p>

        <details>
          <summary>Z. B.</summary>
          <p>Sie können angeben, dass das Element im Suchbereich auf geraden Seiten gesucht werden soll.</p>
          <p>RestrictSearchArea: searchArea, EvenPages;</p>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RestrictSearchArea( SearchAreaPageRestriction pageRestriction, IntArray pages )</p>
      </td>

      <td>
        <p>Schränkt den Seitenbereich ein, in dem gesucht wird, ohne den Suchbereich auf den Seiten selbst einzuschränken. Der Parameter `pageRestriction` hat nur einen möglichen Wert: WholePage.</p>

        <details>
          <summary>Z. B.</summary>
          <p>Sie können festlegen, dass das Element auf den Seiten 2, 4 und 7-9 gesucht werden muss.</p>
          <p>RestrictSearchArea: WholePage, 2 \<\< 4 \<\< 7 \<\< 8 \<\< 9;</p>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RestrictSearchArea( SearchAreaPageRestriction pageRestriction, SearchAreaPageSetType )</p>
      </td>

      <td>
        <details>
          <summary>z. B.</summary>
          <p>Sie können festlegen, dass das Element auf der letzten Seite gesucht werden soll.</p>

          <pre>
            <code>RestrictSearchArea: WholePage, LastPage;</code>
          </pre>
        </details>
      </td>
    </tr>

    <tr>
      <td colspan="2">
        <p>
          <strong>Hinweis.</strong> Sie können den Alias <strong>RSA</strong> statt des vollständigen Namens <strong>RestrictSearchArea</strong> verwenden.
        </p>
      </td>
    </tr>
  </tbody>
</table>

<Note>
  Verschiedene Einschränkungen für dieselbe Seite werden zusammen angewendet, für verschiedene Seiten hingegen unabhängig voneinander. (Die Suche wird auf den Seiten durchgeführt, für die mindestens eine Einschränkung angegeben wurde.)
</Note>

<div id="auxiliary-functions-that-define-the-search-area">
  ## Hilfsfunktionen zum Definieren des Suchbereichs
</div>

<table width="100%">
  <tbody>
    <tr>
      <td>
        <p>Rect PageRect()</p>
      </td>

      <td>
        <p>Das Rechteck der aktuellen Seite in globalen Koordinaten, das zum Angeben eines seitenabhängigen Suchbereichs verwendet wird.</p>

        <p>
          <strong>PageRect</strong> kann nur zum Angeben eines Suchbereichs verwendet werden.
        </p>

        <details>
          <summary>Z. B.</summary>
          <p>Um anzugeben, dass sich das Element in der unteren Hälfte einer Seite befindet (die genaue Seite ist im Voraus nicht bekannt), schreiben Sie:</p>
          <p>Below: PageRect.Top + PageRect.Height / 2;</p>

          <p>
            Verwenden Sie in allen anderen Fällen die Konstruktion <strong>Page( N ).Rect</strong>, um das Rechteck der Seite mit der Nummer <strong>N</strong> abzurufen, oder <strong>DocumentRect</strong>, um das Rechteck des
            gesamten Dokuments abzurufen. Sie können auch die Funktion <strong>PageNumber</strong> verwenden, um einen seitenabhängigen Suchbereich anzugeben.
          </p>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Int PageNumber()</p>
      </td>

      <td>
        <details>
          <summary>Z. B.</summary>
          <p>Angenommen, Sie haben ein wiederkehrendes Element SearchElements.PageHeader. Um auf jeder Seite unterhalb der Instanzen dieses Elements zu suchen, schreiben Sie:</p>
          <p>Below: SearchElements.PageHeader.AllInstances.PageAreaGlobal( PageNumber ).FuzzyRect, 0 \* dot;</p>
        </details>
      </td>
    </tr>
  </tbody>
</table>