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

# Statischer Text

> Konfigurieren Sie die Eigenschaften des Elements „Statischer Text“ in FlexiLayout — Quality, Fehlertoleranz, Grenzwerte für Abstände und Überlappungen, Groß-/Kleinschreibung und Diakritika sowie die Textsuche in Dateien und Datenkatalogen.

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

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

    <tr>
      <td>
        <p>Void MinQuality( Real )</p>
      </td>

      <td>
        <p>Legt die Mindest-Quality der Hypothese fest.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void MaxErrors( Int )</p>
      </td>

      <td>
        <p>Legt die maximale Anzahl von Fehlern bei der Hypothese fest.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void MaxErrorsPart( Real )</p>
      </td>

      <td>
        <p>Legt den maximalen Fehlerprozentsatz in der Hypothese fest.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void MaxErrors( Int number, Real part )</p>
      </td>

      <td>
        <p>
          Legt die maximale Anzahl an Fehlern in der Hypothese fest: <em>number</em> – absolute Anzahl, <em>part</em> – Prozentsatz.
        </p>

        <details>
          <summary>Z. B.</summary>
          <p>Der folgende Code gibt an, dass die absolute Anzahl an Fehlern 3 nicht überschreiten darf und der prozentuale Anteil der Fehler 20 % nicht überschreiten darf.</p>

          <pre>
            <code>MaxErrors(3, 0.2);</code>
          </pre>

          <p>
            <strong>Hinweis.</strong> Von den beiden Bedingungen verwendet die Aktivität die strengere.
          </p>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void MaxGapInLine( Distance )</p>
      </td>

      <td>
        <p>Legt den maximalen Abstand zwischen benachbarten Zeichen fest.</p>
        <p>Beim Generieren einer Hypothese fügt die Aktivität so lange Zeichen hinzu, bis der Abstand zwischen zwei benachbarten Zeichen MaxGapInLine nicht mehr überschreitet.</p>

        <details>
          <summary>Z. B.</summary>
          <p>Der folgende Code gibt für die Aktivität vor, dass der maximale Abstand zwischen benachbarten Zeichen 5 mm nicht überschreiten darf; andernfalls wird eine Nullhypothese generiert.</p>

          <pre>
            <code>MaxGapInLine(5mm);</code>
          </pre>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void MaxRelativeGapInLine( Real )</p>
      </td>

      <td>
        <p>Legt die maximale Distanz zwischen benachbarten Zeichen fest, angegeben als Prozentsatz der Zeilenhöhe.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void AllowChoppedWords( Logic )</p>
      </td>

      <td>
        <p>
          Das Flag gibt an, ob Textobjekte, die nicht vollständig innerhalb der linken und rechten Begrenzungen liegen, in die Hypothese einbezogen werden sollen. Der Standardwert ist <strong>True</strong>.
        </p>

        <details>
          <summary>Z. B.</summary>
          <p>Der folgende Code weist die Activity an, nur unter den Textobjekten nach dem Element zu suchen, die vollständig in den Suchbereich passen.</p>

          <pre>
            <code>AllowChoppedWords(False);</code>
          </pre>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void MaxXOutsidePart( Real )</p>
      </td>

      <td>
        <p>
          Gibt den Anteil des Textobjekts an, der in horizontaler Richtung außerhalb des Suchbereichs liegen darf. Dieser Anteil des Textobjekts wird durch eine Zahl von 0 bis 1 angegeben. Ein Textobjekt wird
          in die Hypothese einbezogen, wenn der Anteil des Textobjekts außerhalb des Suchbereichs nicht größer ist als der durch diesen Parameter angegebene Wert.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void MaxYOutsidePart( Real )</p>
      </td>

      <td>
        <p>
          Gibt an, welcher Teil des Textobjekts in vertikaler Richtung außerhalb des Suchbereichs liegen darf. Dieser Anteil des Textobjekts wird als Zahl zwischen 0 und 1 angegeben. Ein Textobjekt wird
          in die Hypothese aufgenommen, wenn der außerhalb des Suchbereichs liegende Anteil des Textobjekts nicht größer ist als der in diesem Parameter angegebene Wert.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void CaseSensitive( Logic Value=true )</p>
      </td>

      <td>
        <p>
          Unterscheidet zwischen Klein- und Großschreibung, wenn <strong>True</strong> festgelegt ist.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void IgnoreAccents( Logic value = true )</p>
      </td>

      <td>
        <p>
          Ignoriert bzw. berücksichtigt Diakritika bei der Textsuche nicht. Wenn der Wert auf <strong>True</strong> gesetzt ist, werden Diakritika ignoriert (zum Beispiel werden die Wörter "café" und "cafe" als identisch
          behandelt).
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a id="SearchFromFile" />Void SearchTextFromFile( String fileName, Int maxRecordsCount = 1000 )
        </p>
      </td>

      <td>
        <p>
          Legt die Menge der Zeichenfolgen fest, nach denen mithilfe einer <em>fileName</em>-Textdatei in einem Bild gesucht wird. Weitere Informationen zur Verwendung von TXT-Dateien finden Sie unter{" "}
          <a href="/de/vantage/documentation/advanced-designer/activities/flexilayout/user-dictionaries">User Dictionaries</a> und{" "}
          <a href="/de/vantage/documentation/advanced-designer/activities/extraction-rules/static-text">Static Text Element</a>.
        </p>

        <p>
          Um die Suche zu beschleunigen, werden nur die ersten <em>maxRecordsCount</em> Varianten verwendet (die Standardeinstellung ist 1000).
        </p>

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

          <pre>
            <code>SearchTextFromFile: "Keywords.txt", 500;</code>
          </pre>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void SearchTextFromCatalog( String catalogParameterName, Int columnIndex, NamedValueArray searchCriteria = EmptyNamedValueArray, Int maxRecordsCount = 1000 )</p>
      </td>

      <td>
        <p>
          Ruft Werte aus der Spalte mit dem Index <em>columnIndex</em> im Datenkatalog ab, auf den der Parameter <em>catalogParameterName</em> verweist, und verwendet diese Werte als Menge von Strings,
          nach denen in einem Bild gesucht werden soll. Sie können Spaltenindizes mit einer der folgenden globalen Funktionen ermitteln: FieldNamesOfCatalog, GetCatalogColumnIndex, GetCatalogColumnIndices.
        </p>

        <p>
          Die Datensätze können anhand der Suchkriterien gefiltert werden, die über ein Array benannter Werte festgelegt werden. Dabei steht jeder benannte Wert für den Spaltennamen und den erwarteten Wert. Die Menge der zu suchenden Strings
          enthält nur die Werte aus den Datensätzen, die den Suchkriterien entsprechen.
        </p>

        <details>
          <summary>Z. B.</summary>
          <p>Der folgende Code weist die Aktivität an, nach Werten aus der 2. Spalte des Datenkatalogs zu suchen, auf den der Parameter CompanyCatalog verweist:</p>

          <pre>
            <code>SearchTextFromCatalog( "CompanyCatalog", 2 );</code>
          </pre>

          <p>
            Der folgende Code filtert die Datensätze anhand des Werts in der Spalte "CompanyName". Der Wert aus der 2. Spalte wird dem Zu findenden Text nur dann hinzugefügt, wenn der Wert in der Spalte "CompanyName"
            für den entsprechenden Datensatz "ABBYY" ist.
          </p>

          <pre>
            <code>
              NamedValueArray searchCriteria = NamedValue( "CompanyName", "ABBYY" );

              <br />

              SearchTextFromCatalog( "CompanyCatalog", 2, searchCriteria );
            </code>
          </pre>

          <p>Der folgende Code verwendet die Hilfsmethode GetCatalogColumnIndex, um den Spaltenindex anhand seines Namens zu ermitteln:</p>

          <pre>
            <code>SearchTextFromCatalog( "CompanyCatalog", GetCatalogColumnIndex( "CompanyCatalog", "ColumnName" ));</code>
          </pre>
        </details>

        <p>
          Um die Abfrage zu beschleunigen, wird nur auf die ersten <em>maxRecordsCount</em> Datensätze zugegriffen (standardmäßig 1000).
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void AllowIntersectPercent( Real )</p>
      </td>

      <td>
        <p>Gibt den maximal zulässigen Prozentsatz der vertikalen Überlappung zweier Textzeilen an (Standardeinstellung: 15). Dieser Parameter kann für Texte mit geringem Zeilenabstand nützlich sein.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void SearchText( String )</p>
      </td>

      <td>
        <p>
          Legt den Text fest, der in einem Bild gesucht wird. Die Zeichenfolge kann mehrere Suchvarianten enthalten, die durch "|" getrennt sind (der ODER-Operator). Weitere Informationen finden Sie unter{" "}
          <a href="/de/vantage/documentation/advanced-designer/activities/extraction-rules/static-text">Typspezifische Eigenschaften des Elements „Static Text“</a>.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="2">
        <p>
          <em>Die folgenden Methoden stehen zur Verfügung, wenn der zu findende Text aus mehreren Wörtern besteht.</em>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void NextLinePenalty( Real )</p>
      </td>

      <td>
        <p>
          Legt einen Strafwert für Zeilenumbrüche fest. Der Strafwert ist eine Zahl von 0 bis 1. Die Quality der Hypothese wird so oft mit dieser Zahl multipliziert, wie die Phrase Zeilenumbrüche enthält. Wenn
          Zeilenumbrüche in der Phrase zulässig sind, setzen Sie diesen Parameter auf 1 (die Multiplikation der Quality der Hypothese mit 1 verringert ihre Quality nicht).
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void OmissionPenalty( Real )</p>
      </td>

      <td>
        <p>
          Legt eine Gewichtung für fehlende Wörter fest. Die Gewichtung ist eine Zahl von 0 bis 1. Die Quality der Hypothese wird mit dieser Zahl so oft multipliziert, wie Wörter in der Phrase fehlen.
          Wenn einige Wörter in der Phrase fehlen dürfen, setzen Sie diesen Parameter auf 1 (die Multiplikation der Quality der Hypothese mit 1 mindert ihre Quality nicht).
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void WholeWordMode( Logic )</p>
      </td>

      <td>
        <p>
          Gibt an, ob nur vollständige Textobjekte als gültige Hypothesen berücksichtigt werden sollen. Wenn <strong>True</strong> gesetzt ist, werden Hypothesen ignoriert, die aus Wortteilen bestehen. Die Standardeinstellung
          ist <strong>False</strong>.
        </p>

        <p>
          <strong>Hinweis.</strong> Diese Methode unterscheidet sich von <strong>AllowChoppedWords</strong> dadurch, dass <strong>AllowChoppedWords</strong> sich nur auf Hypothesen auswirkt, die aus Wörtern an der
          Grenze des Suchbereichs erzeugt werden, während <strong>WholeWordMode</strong> die Generierung aller Hypothesen beeinflusst.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void AllowEmbeddedHypotheses( Logic )</p>
      </td>

      <td>
        <p>
          Legt den Modus für die Bildung von Hypothesen fest. Um alle möglichen Hypothesen zu bilden (einschließlich überlappender und verschachtelter), setzen Sie den Wert auf <strong>True</strong>. Um Hypothesen mit maximaler
          Länge zu bilden, setzen Sie ihn auf <strong>False</strong>.
        </p>

        <details>
          <summary>Z. B.</summary>
          <p>Der folgende Code weist die Aktivität an, die längste Hypothese zu bilden.</p>

          <pre>
            <code>AllowEmbeddedHypotheses(False);</code>
          </pre>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void MaxLineBreakDistance( Distanz )</p>
      </td>

      <td>
        <p>Legt den horizontalen Abstand zwischen Wörtern in unterschiedlichen Zeilen fest, wenn Zeilenumbrüche innerhalb der Phrase zulässig sind.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void SuggestOnlySimilarChars( Logic value )</p>
      </td>

      <td>
        <p>
          Gibt an, welche Zeichen die Aktivität bei einer Fuzzy-Suche als Ersatzzeichen verwenden kann. Wenn die Option auf <strong>True</strong> gesetzt ist, verwendet die Aktivität als Ersatzzeichen nur Zeichen mit
          einer ähnlichen Kontur.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void AllowedTextRotations( TextRotations )</p>
      </td>

      <td>
        <p>Legt die zulässigen Orientierungen für den erkannten Text fest. Eine Hypothese wird nur gebildet, wenn der erkannte Text eine von diesem Parameter zugelassene Orientierung aufweist.</p>
      </td>
    </tr>
  </tbody>
</table>