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

# Zeichenkette

> Legen Sie die Eigenschaften des Zeichenkette-Elements in der FlexiLayout-Sprache fest: Alphabete, reguläre Ausdrücke, Quality-Grenzwerte, Wortanzahlen und Abstandsbeschränkungen.

Das **Zeichenkette**-Element unterstützt in der FlexiLayout-Sprache die folgenden Parameter.

<div id="character-string-parameters">
  ## Zeichenkettenparameter
</div>

| Parameter                                                                                                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Void AllowEmbeddedHypotheses( Logic )`                                                                    | Siehe [**Zeichenkette**](/de/flexi-capture/fls/template/character-chain), **Eingebettete Hypothesen zulassen**.                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `Void MinQuality( Real )`                                                                                  | Legt die Mindestqualität der Hypothese fest. Hypothesen mit einer Qualität unter diesem Mindestwert werden verworfen.                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `Void MaxNonDefinedCount( Real )`                                                                          | Siehe [**Zeichenkette**](/de/flexi-capture/fls/template/character-chain), **Prozentsatz der nicht alphabetischen Zeichen**.                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `Void MaxWordBreakCount( Real )`                                                                           | Die maximale Anzahl von Wortenden in der Zeile. Die Zeile wird anhand des Parameters **Wörter erkennen anhand des Zwischenraums zwischen Wörtern** in Wörter unterteilt (siehe Dialogfeld **Elementeigenschaften**, Registerkarte [**Zeichenkette**](/de/flexi-capture/fls/template/character-chain)). Der Parameter wird als Verhältnis angegeben: `[number of word ends]/[number of characters in the string]`.                                                                                                                                                         |
| `Void MinInterwordSpace( Distance )`                                                                       | Ermöglicht die Unterteilung in Wörter anhand der Breite des Wortzwischenraums (siehe Dialogfeld **Elementeigenschaften**, Registerkarte [**Zeichenkette**](/de/flexi-capture/fls/template/character-chain), **Wörter erkennen anhand von Wortzwischenräumen**) und gibt die Mindestbreite des Wortzwischenraums als `Distance` an (Parameter **Minimaler Wortzwischenraum**).                                                                                                                                                                                             |
| `Void WordsCount( Int, Int, Int, Int )`                                                                    | Siehe im Dialogfeld **Elementeigenschaften** auf der Registerkarte [**Zeichenkette**](/de/flexi-capture/fls/template/character-chain) **Wortanzahl**.                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `Void TotalChainLength( Int, Int, Int, Int )`                                                              | Siehe [**Zeichenkette**](/de/flexi-capture/fls/template/character-chain), **Anzahl der Zeichen**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `Void TotalGapLength( Distance, Distance, Distance, Distance )`                                            | Legt die maximal zulässige Gesamtlänge von Leerzeichen in der Zeichenfolge als [Fuzzy-Intervall](/de/flexi-capture/fls/template/fuzzy-interval) fest. Die Qualität der Hypothesen wird anhand der Gesamtlänge der Leerzeichen bewertet.                                                                                                                                                                                                                                                                                                                                   |
| `Void MaxGapInLine( Distance )`                                                                            | Legt den maximalen Abstand zwischen benachbarten Zeichen fest. Beim Generieren einer Hypothese fügt FlexiLayout Studio ihr so lange Zeichen hinzu, wie der Abstand zwischen zwei benachbarten Zeichen `MaxGapInLine` nicht überschreitet. Siehe auch [**Zeichenkette**](/de/flexi-capture/fls/template/character-chain), **Max. Leerraumlänge**.                                                                                                                                                                                                                          |
| `Void MaxRelativeGapInLine( Real )`                                                                        | Die maximale Distanz zwischen benachbarten Zeichen, ausgedrückt als Prozentsatz der Zeilenhöhe.                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `Void AllowChoppedWords( Logic )`                                                                          | Dieses 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 `true`.                                                                                                                                                                                                                                                                                                                                                                                  |
| `Void MaxXOutsidePart( Real )`                                                                             | Gibt den Anteil des Zeichens an, der horizontal über den Suchbereich hinausragen darf. Der Anteil des Zeichens wird durch eine Zahl von `0` bis `1` angegeben. Zeichen, bei denen der außerhalb des Suchbereichs liegende Anteil dem angegebenen Wert entspricht oder kleiner ist, werden in die Hypothese aufgenommen.                                                                                                                                                                                                                                                   |
| `Void MaxYOutsidePart( Real )`                                                                             | Gibt an, welcher Anteil des Zeichens vertikal über den Suchbereich hinausragen darf. Der Anteil des Zeichens wird als Zahl von `0` bis `1` angegeben. Zeichen, bei denen der angegebene oder ein kleinerer Anteil außerhalb des Suchbereichs liegt, werden in die Hypothese aufgenommen.                                                                                                                                                                                                                                                                                  |
| `Void AddAlphabet( String alphabet, Real portion, Logic isRestrictionStrong )`                             | Legt das Alphabet und den zulässigen Anteil an Alphabetzeichen in der Hypothese fest. Das Flag `isRestrictionStrong` gibt an, ob Hypothesen, die den zulässigen Anteil an Alphabetzeichen überschreiten, noch als gültig betrachtet werden sollen. Wenn das Flag auf `true` gesetzt ist, werden Hypothesen, die den zulässigen Anteil überschreiten, verworfen. Wenn das Flag auf `false` gesetzt ist, werden überschüssige Symbole so behandelt, als gehörten sie zu keinem Alphabet. Die Standardeinstellung ist `true`.                                                |
| `Void RegularExpression( String )`                                                                         | Legt den regulären Ausdruck fest, der den Text der Hypothese definiert.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `Void WholeWordMode ( Logic )`                                                                             | Dieses Flag gibt an, ob nur ganze Wörter als gültige Hypothesen berücksichtigt werden. Wenn das Flag auf `true` gesetzt ist, werden Hypothesen verworfen, die aus Wortteilen bestehen. Die Standardeinstellung ist `false`. **Hinweis.** Diese Eigenschaft unterscheidet sich von `AllowChoppedWords`, da `AllowChoppedWords` nur die Bildung von Hypothesen beeinflusst, die aus Wörtern am Rand des Suchbereichs bestehen, während `WholeWordMode` die Bildung sämtlicher Hypothesen beeinflusst.                                                                       |
| `Void RegularExpressionFromDB( String connectionString, String selectString, Int maxRecordsCount = 1000 )` | Verwendet eine Datenbank zum Festlegen des regulären Ausdrucks, der den Text der Hypothesen definiert. Weitere Informationen finden Sie unter [Datenbanken und Textdateien in der FlexiLayout-Sprache](/de/flexi-capture/fls/language/bd-textfiles). Das Argument `connectionString` legt die Verbindungszeichenfolge für die Datenbank fest. Das Argument `selectString` legt eine SQL-Abfrage fest, die mit dem Befehl `SELECT` beginnt. Um die Suche zu beschleunigen, werden nur die ersten `maxRecordsCount` Varianten verwendet (die Standardeinstellung ist 1000). |
| `Void RegularExpressionFromFile( String fileName, Int maxRecordsCount = 1000 )`                            | Verwendet eine Textdatei, um den regulären Ausdruck festzulegen, der den Text der Hypothesen bestimmt. Weitere Informationen finden Sie unter [Datenbanken und Textdateien in der FlexiLayout-Sprache](/de/flexi-capture/fls/language/bd-textfiles). Das Argument `fileName` legt den Namen der Textdatei fest. Um die Suche zu beschleunigen, werden nur die ersten `maxRecordsCount` Varianten verwendet (die Standardeinstellung ist 1000).                                                                                                                            |
| `Void Width( Distance, Distance, Distance, Distance )`                                                     | Die Breite der Hypothese, angegeben als [fuzzy interval](/de/flexi-capture/fls/template/fuzzy-interval).                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `Void Height( Distance, Distance, Distance, Distance )`                                                    | Die Höhe der Hypothese, angegeben als [fuzzy interval](/de/flexi-capture/fls/template/fuzzy-interval).                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `Void TrimSymbols( String )`                                                                               | Gibt die Zeichen an, die am Anfang und am Ende einer Hypothese entfernt werden sollen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `Void SimilarSymbolQuality( Real )`                                                                        | Gibt einen Koeffizienten an, mit dem die Quality einer Hypothese multipliziert werden soll, wenn sie ein Zeichen aus der Liste der Zeichen enthält, die den Zeichen des Alphabets ähneln.                                                                                                                                                                                                                                                                                                                                                                                 |
| `Void AllowedTextRotations ( TextRotations )`                                                              | Gibt eine Menge von Orientierungen des erkannten Textes an, in denen eine Elementsuche zulässig ist.                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

<div id="parameter-examples">
  ## Parameterbeispiele
</div>

<div id="allowembeddedhypotheses">
  ### `AllowEmbeddedHypotheses`
</div>

Der folgende Code weist FlexiLayout Studio an, die längste Hypothese zu generieren.

```text theme={null}
AllowEmbeddedHypotheses (False);
```

<div id="minquality">
  ### `MinQuality`
</div>

Der folgende Code veranlasst FlexiLayout Studio, Hypothesen zu ignorieren, deren Qualität unter 0,95 liegt.

```text theme={null}
MinQuality: 0.95;
```

<div id="maxnondefinedcount">
  ### `MaxNonDefinedCount`
</div>

Der folgende Code weist FlexiLayout Studio an, dass die Zeichenfolge bis zu 30 % Zeichen enthalten darf, die zu keinem der angegebenen Alphabete gehören.

```text theme={null}
MaxNonDefinedCount (0.3);
```

<div id="totalchainlength">
  ### `TotalChainLength`
</div>

Der folgende Code weist FlexiLayout Studio an, nach einer Zeile mit 5 bis 10 Zeichen zu suchen.

```text theme={null}
TotalChainLength (4, 5, 10, 11);
```

<div id="maxgapinline">
  ### `MaxGapInLine`
</div>

Der folgende Code legt in FlexiLayout Studio fest, dass der maximale Abstand zwischen benachbarten Zeichen 5 mm nicht überschreiten darf. Andernfalls wird eine Nullhypothese erzeugt.

```text theme={null}
MaxGapInLine (5mm);
```

<div id="addalphabet">
  ### `AddAlphabet`
</div>

Der folgende Code weist FlexiLayout Studio an, ein Alphabet hinzuzufügen, das aus den Zeichen №, #, % und `*` besteht, deren Anteil in der Hypothese 10 % nicht überschreiten darf.

```text theme={null}
AddAlphabet ("№#%*", 0.1, True);
```

<Note>
  Sie können nur Zeichen hinzufügen, die nicht Bestandteil eines der für das aktuelle Element angegebenen Alphabete sind.
</Note>

<div id="regularexpression">
  ### `RegularExpression`
</div>

Der folgende reguläre Ausdruck sucht nach einer Zeichenfolge, deren Zeichen auf eine von zwei Arten angeordnet sein können: 2 Ziffern, ein Bindestrich (`-`), 1 Ziffer; oder der Buchstabe `N`, eine Ziffer von 1 bis 5, ein Schrägstrich (`/`) und 1 bis 3 Ziffern.

```text theme={null}
RegularExpression: ("([0-9]{2}[-][0-9])|([N][1-5][/][0-9]{1-3})");
```

Dies entspricht:

```text theme={null}
RegularExpression: ("([0-9]{2}\"-\"[0-9])|(\"N\"[1-5]\"/\"[0-9]{1-3})");
```
