> ## 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.
# Character String
> Définissez les propriétés de l’élément Character String dans le langage FlexiLayout : alphabets, expressions régulières, limites de qualité, nombre de mots et contraintes d’écart.
L’élément **Character String** prend en charge les paramètres suivants en langage FlexiLayout.
## Paramètres de Character String
| Parameter | Description |
| ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Void AllowEmbeddedHypotheses( Logic )` | Voir [**Character String**](/fr/flexi-capture/fls/template/character-chain), **Autoriser les hypothèses imbriquées**. |
| `Void MinQuality( Real )` | Définit la qualité minimale de l’hypothèse. Les hypothèses dont la qualité est inférieure à ce minimum sont ignorées. |
| `Void MaxNonDefinedCount( Real )` | Voir [**Character String**](/fr/flexi-capture/fls/template/character-chain), **Pourcentage de caractères non alphabétiques**. |
| `Void MaxWordBreakCount( Real )` | Le nombre maximal de fins de mots sur la ligne. La ligne est divisée en mots selon le paramètre **Détecter les mots selon l’espace intermot** (voir la boîte de dialogue **Propriétés de l’élément**, onglet [**Character String**](/fr/flexi-capture/fls/template/character-chain)). Le paramètre est exprimé sous la forme du rapport : `[nombre de fins de mots]/[nombre de caractères dans la chaîne]`. |
| `Void MinInterwordSpace( Distance )` | Permet de diviser le texte en mots en fonction de la largeur de l’espace (voir la boîte de dialogue **Propriétés de l’élément**, onglet [**Character String**](/fr/flexi-capture/fls/template/character-chain), **Détecter les mots selon l’espace entre les mots**) et définit `Distance` comme largeur minimale de l’espace (paramètre **Min interword space**). |
| `Void WordsCount( Int, Int, Int, Int )` | Voir la boîte de dialogue **Propriétés de l’élément**, onglet [**Character String**](/fr/flexi-capture/fls/template/character-chain), **Nombre de mots**. |
| `Void TotalChainLength( Int, Int, Int, Int )` | Voir [**Character String**](/fr/flexi-capture/fls/template/character-chain), **Nombre de caractères**. |
| `Void TotalGapLength( Distance, Distance, Distance, Distance )` | Spécifie la longueur totale maximale autorisée des espaces dans la chaîne de caractères sous la forme d’un [intervalle flou](/fr/flexi-capture/fls/template/fuzzy-interval). La qualité des hypothèses est évaluée en fonction de la longueur totale des espaces. |
| `Void MaxGapInLine( Distance )` | Définit la distance maximale entre caractères voisins. Lors de la génération d’une hypothèse, FlexiLayout Studio ajoute des caractères à l’hypothèse tant que la distance entre deux caractères voisins ne dépasse pas `MaxGapInLine`. Voir aussi [**Character String**](/fr/flexi-capture/fls/template/character-chain), **Longueur d’espace maximale**. |
| `Void MaxRelativeGapInLine( Real )` | Distance maximale entre des caractères voisins, exprimée en pourcentage de la hauteur de la ligne. |
| `Void AllowChoppedWords( Logic )` | Cet indicateur précise si les objets texte qui ne sont pas entièrement compris entre les limites gauche et droite doivent être inclus dans l’hypothèse. La valeur par défaut est `true`. |
| `Void MaxXOutsidePart( Real )` | Spécifie la proportion du caractère qui peut dépasser horizontalement de la zone de recherche. Cette proportion est définie par un nombre compris entre `0` et `1`. Les caractères dont la partie située en dehors de la zone de recherche est égale ou inférieure à la valeur spécifiée sont inclus dans l’hypothèse. |
| `Void MaxYOutsidePart( Real )` | Spécifie la partie du caractère qui peut dépasser verticalement la zone de recherche. La partie du caractère est spécifiée par un nombre compris entre `0` et `1`. Les caractères dont la partie située hors de la zone de recherche est égale ou inférieure à la valeur spécifiée sont inclus dans l’hypothèse. |
| `Void AddAlphabet( String alphabet, Real portion, Logic isRestrictionStrong )` | Définit l’alphabet et le pourcentage autorisé de caractères de cet alphabet dans l’hypothèse. L’indicateur `isRestrictionStrong` précise si les hypothèses qui dépassent le pourcentage admissible de caractères de cet alphabet doivent être considérées comme valides. Si l’indicateur est défini sur `true`, les hypothèses qui dépassent le pourcentage admissible sont rejetées. Si l’indicateur est défini sur `false`, les symboles excédentaires sont considérés comme n’appartenant à aucun alphabet. Le réglage par défaut est `true`. |
| `Void RegularExpression( String )` | Définit l’expression régulière décrivant le texte de l’hypothèse. |
| `Void WholeWordMode ( Logic )` | Cet indicateur spécifie si seuls des mots entiers doivent être considérés comme des hypothèses valides. Si l’indicateur est défini sur `true`, les hypothèses constituées de fragments de mots sont écartées. La valeur par défaut est `false`. **Remarque.** Cette propriété diffère de `AllowChoppedWords`, car `AllowChoppedWords` n’affecte que la formulation des hypothèses constituées de mots situés sur la limite de la zone de recherche, tandis que `WholeWordMode` affecte la formulation de toutes les hypothèses. |
| `Void RegularExpressionFromDB( String connectionString, String selectString, Int maxRecordsCount = 1000 )` | Utilise une base de données pour définir l’expression régulière décrivant le texte des hypothèses. Pour plus d’informations, voir [Bases de données et fichiers texte dans le langage FlexiLayout](/fr/flexi-capture/fls/language/bd-textfiles). L’argument `connectionString` définit la chaîne de connexion à la base de données. L’argument `selectString` définit une requête SQL qui commence par la commande `SELECT`. Pour accélérer la recherche, seules les `maxRecordsCount` premières variantes sont utilisées (la valeur par défaut est 1000). |
| `Void RegularExpressionFromFile( String fileName, Int maxRecordsCount = 1000 )` | Utilise un fichier texte pour définir l’expression régulière décrivant le texte des hypothèses. Pour plus d’informations, voir [Bases de données et fichiers texte dans le langage FlexiLayout](/fr/flexi-capture/fls/language/bd-textfiles). L’argument `fileName` définit le nom du fichier texte. Pour accélérer la recherche, seules les `maxRecordsCount` premières variantes sont prises en compte (la valeur par défaut est 1000). |
| `Void Width( Distance, Distance, Distance, Distance )` | La largeur de l’hypothèse spécifiée sous forme d’[intervalle flou](/fr/flexi-capture/fls/template/fuzzy-interval). |
| `Void Height( Distance, Distance, Distance, Distance )` | La hauteur de l’hypothèse spécifiée sous forme d’[intervalle flou](/fr/flexi-capture/fls/template/fuzzy-interval). |
| `Void TrimSymbols( String )` | Spécifie les caractères à supprimer au début et à la fin d’une hypothèse. |
| `Void SimilarSymbolQuality( Real )` | Spécifie un coefficient par lequel la qualité d’une hypothèse doit être multipliée si elle contient un caractère figurant dans la liste des caractères ressemblant à ceux de l’alphabet. |
| `Void AllowedTextRotations ( TextRotations )` | Spécifie un ensemble d’orientations du texte reconnu pour lesquelles la recherche d’un élément est autorisée. |
## Exemples de Parameter
### `AllowEmbeddedHypotheses`
Le code suivant indique à FlexiLayout Studio de produire l’hypothèse la plus longue.
```text theme={null}
AllowEmbeddedHypotheses (False);
```
### `MinQuality`
Le code suivant indique à FlexiLayout Studio d’ignorer les hypothèses dont la qualité est inférieure à 0,95.
```text theme={null}
MinQuality: 0.95;
```
### `MaxNonDefinedCount`
Le code suivant indique à FlexiLayout Studio que la chaîne peut contenir jusqu’à 30 % de caractères n’appartenant à aucun des alphabets spécifiés.
```text theme={null}
MaxNonDefinedCount (0.3);
```
### `TotalChainLength`
Le code suivant indique à FlexiLayout Studio de rechercher une ligne de 5 à 10 caractères.
```text theme={null}
TotalChainLength (4, 5, 10, 11);
```
### `MaxGapInLine`
Le code suivant indique à FlexiLayout Studio que la distance maximale entre deux caractères adjacents ne doit pas dépasser 5 mm. Sinon, une hypothèse nulle est générée.
```text theme={null}
MaxGapInLine (5mm);
```
### `AddAlphabet`
Le code suivant demande à FlexiLayout Studio d’ajouter un alphabet composé des caractères №, #, % et `*`, dont le pourcentage dans l’hypothèse ne doit pas dépasser 10 %.
```text theme={null}
AddAlphabet ("№#%*", 0.1, True);
```
Vous ne pouvez ajouter que des caractères qui ne font partie d’aucun des alphabets spécifiés pour l’élément actuel.
### `RegularExpression`
L’expression régulière suivante recherche une chaîne de caractères dont les caractères peuvent être agencés de l’une des deux façons suivantes : 2 chiffres, un tiret (`-`), 1 chiffre ; ou la lettre `N`, un chiffre de 1 à 5, une barre oblique (`/`), de 1 à 3 chiffres.
```text theme={null}
RegularExpression: ("([0-9]{2}[-][0-9])|([N][1-5][/][0-9]{1-3})");
```
Cela équivaut à :
```text theme={null}
RegularExpression: ("([0-9]{2}\"-\"[0-9])|(\"N\"[1-5]\"/\"[0-9]{1-3})");
```