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

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

      <td>
        <p>
          <strong>Description</strong>
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Voir <em>Character String. Autoriser les hypothèses imbriquées.</em>
        </p>

        <details>
          <summary>P. ex.</summary>
          <p>Le code ci-dessous indique au programme de générer l’hypothèse la plus longue.</p>

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

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

      <td>
        <p>Définit la qualité minimale d’une hypothèse. Les hypothèses dont la qualité est inférieure à ce minimum seront ignorées.</p>

        <details>
          <summary>Par ex.</summary>
          <p>Le code ci-dessous indique au programme d’ignorer les hypothèses dont la qualité est inférieure à 0.95.</p>

          <pre>
            <code>MinQuality: 0.95;</code>
          </pre>
        </details>
      </td>
    </tr>

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

      <td>
        <p>
          Voir <em>Character String. Pourcentage de caractères n’appartenant à aucun alphabet.</em>
        </p>

        <details>
          <summary>Par ex.</summary>
          <p>Le code ci-dessous indique au programme que la chaîne peut contenir jusqu’à 30 % de caractères n’appartenant à aucun des alphabets spécifiés.</p>

          <pre>
            <code>MaxNonDefinedCount (0.3);</code>
          </pre>
        </details>
      </td>
    </tr>

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

      <td>
        <p>
          Le nombre maximal de fins de mots dans la ligne. La ligne est divisée en mots en fonction du paramètre Détecter les mots selon l’espace intermot (voir{" "}
          <em>boîte de dialogue Propriétés de l’élément, onglet Character String</em>). Le paramètre est spécifié sous forme de rapport : \[nombre de fins de mots]/\[nombre de caractères de la string].
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Active la segmentation en mots en fonction de la largeur de l’espace (voir la <em>boîte de dialogue Propriétés, onglet Character String, </em>Détecter les mots selon l’espace intermot) et définit la largeur
          minimale de l’espace à <strong>Distance</strong> (paramètre Min interword space).
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void WordsCount( Int, Int, Int, Int )</p>
      </td>

      <td>
        <p>
          Voir <em>la boîte de dialogue Propriétés de l’élément, l’onglet Character String, Nombre de mots.</em>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void TotalChainLength( Int, Int, Int, Int )</p>
      </td>

      <td>
        <p>
          Voir <em>Character String, nombre de caractères.</em>
        </p>

        <details>
          <summary>Par ex.</summary>
          <p>Le code ci-dessous indique au programme de rechercher une ligne de 5 à 10 caractères.</p>

          <pre>
            <code>TotalChainLength (4, 5, 10, 11);</code>
          </pre>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void TotalGapLength( Distance, Distance, Distance, Distance )</p>
      </td>

      <td>
        <p>
          Spécifie la longueur totale maximale autorisée des espaces dans la chaîne sous la forme d’un <a href="/fr/flexi-capture/fls/template/fuzzy-interval">intervalle flou</a>. Évalue la qualité des hypothèses en fonction de
          la longueur totale des espaces.
        </p>
      </td>
    </tr>

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

      <td>
        <p>Définit la distance maximale entre deux caractères adjacents.</p>
        <p>Lors de la génération d’une hypothèse, le programme ajoute des caractères à l’hypothèse jusqu’à ce que la distance entre deux caractères adjacents ne dépasse pas MaxGapInLine.</p>

        <p>
          Voir aussi <em>Character String, Character String, Longueur maximale de l’espace.</em>
        </p>

        <details>
          <summary>P. ex.</summary>
          <p>Le code ci-dessous indique au programme 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.</p>

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

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

      <td>
        <p>La distance maximale entre deux caractères adjacents, exprimée en pourcentage de la hauteur de ligne.</p>
      </td>
    </tr>

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

      <td>
        <p>
          Cet indicateur indique si les objets texte qui ne sont pas entièrement compris entre les limites de gauche et de droite doivent être inclus dans l’hypothèse. La valeur par défaut est <strong>True</strong>.
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Spécifie la partie du caractère qui peut s’étendre horizontalement au-delà de la zone de recherche. Cette partie du caractère est exprimée par un nombre compris entre 0 et 1. Sont inclus dans
          l’hypothèse les caractères dont la partie située en dehors de la zone de recherche est inférieure ou égale à la valeur spécifiée.
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Spécifie la partie du caractère qui peut dépasser verticalement de la zone de recherche. Cette partie du caractère est exprimée par un nombre compris entre 0 et 1. Sont inclus dans l’hypothèse
          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.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void AddAlphabet( String alphabet, Real portion, Logic isRestrictionStrong )</p>
      </td>

      <td>
        <p>
          Définit l’alphabet et le pourcentage autorisé de caractères de cet alphabet dans l’hypothèse. L’indicateur isRestrictionStrong précise si un dépassement du taux autorisé de symboles de l’alphabet doit
          être considéré comme une hypothèse valide :
        </p>

        <ul>
          <li>
            Si l’indicateur est défini sur <strong>True</strong>, les hypothèses seront rejetées lorsqu’elles dépassent le taux autorisé.
          </li>

          <li>
            Si l’indicateur est défini sur <strong>False</strong>, les symboles excédentaires seront considérés comme n’appartenant à aucun alphabet.
          </li>
        </ul>

        <p>
          La valeur par défaut est <strong>True</strong>.
        </p>

        <details>
          <summary>Par ex.</summary>
          <p>Le code ci-dessous indique au programme d’ajouter un alphabet composé des caractères №, #, % et \*, dont le pourcentage dans l’hypothèse ne peut pas dépasser 10 %.</p>

          <p>
            <strong>Remarque.</strong> Vous pouvez uniquement ajouter des caractères qui ne font partie d’aucun des alphabets spécifiés pour l’élément actuel.
          </p>

          <pre>
            <code>AddAlphabet ("№#%\*", 0.1, True);</code>
          </pre>
        </details>
      </td>
    </tr>

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

      <td>
        <p>Définit l’expression régulière qui décrit le texte de l’hypothèse.</p>

        <details>
          <summary>P. ex.</summary>

          <p>
            Voici une expression régulière qui recherche une chaîne dont les caractères peuvent se présenter selon l’une des deux formes suivantes : 2 chiffres, - (tiret), 1 chiffre, ou la lettre N, un chiffre de 1 à 5, / (barre oblique),
            1 à 3 chiffres.
          </p>

          <p>RegularExpression: ("(\[0-9]\{2}\[-]\[0-9])|(\[N]\[1-5]\[/]\[0-9]\{1-3})");</p>
          <p>ce qui revient au même que :</p>

          <pre>
            <code>RegularExpression: ("(\[0-9]\{2}"-"\[0-9])|("N"\[1-5]"/"\[0-9]\{1-3})");</code>
          </pre>
        </details>
      </td>
    </tr>

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

      <td>
        <p>
          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 <strong>True</strong>, les hypothèses constituées de fragments de mots seront rejetées. La
          valeur par défaut est <strong>False</strong>.
        </p>

        <p>
          <strong>Remarque.</strong> Cette propriété diffère de <strong>AllowedChoppedWords</strong> en ce que <strong>AllowChoppedWords</strong> n’affecte que la formulation des hypothèses composées de mots
          situés sur la limite de la zone de recherche, tandis que <strong>WholeWordMode</strong> affecte la formulation de toutes les hypothèses.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RegularExpressionFromDB( String connectionString, String selectString, Int maxRecordsCount = 1000 )</p>
      </td>

      <td>
        <p>
          Utilise une base de données pour définir l’expression régulière décrivant le texte des hypothèses (voir{" "}
          <a href="/fr/flexi-capture/fls/language/bd-textfiles">Utilisation des bases de données et des fichiers texte dans le langage FlexiLayout</a>). L’argument connectionString définit la chaîne de connexion à la
          base de données. L’argument selectString définit une requête SQL commençant 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\).
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void RegularExpressionFromFile( String fileName, Int maxRecordsCount = 1000 )</p>
      </td>

      <td>
        <p>
          Utilise un fichier texte pour définir l’expression régulière correspondant au texte des hypothèses (voir{" "}
          <a href="/fr/flexi-capture/fls/language/bd-textfiles">Utilisation de bases de données et de fichiers texte dans le langage FlexiLayout</a>). L’argument fileName définit le nom du fichier texte. Pour accélérer la
          recherche, seules les maxRecordsCount premières variantes sont utilisées (la valeur par défaut est 1000).
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Width( Distance, Distance, Distance, Distance )</p>
      </td>

      <td>
        <p>
          La largeur de l’hypothèse définie comme un <a href="/fr/flexi-capture/fls/template/fuzzy-interval">intervalle flou</a>.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Void Height( Distance, Distance, Distance, Distance )</p>
      </td>

      <td>
        <p>
          La hauteur de l’hypothèse, spécifiée sous forme d’un <a href="/fr/flexi-capture/fls/template/fuzzy-interval">intervalle flou</a>.
        </p>
      </td>
    </tr>

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

      <td>
        <p>Spécifie les caractères à supprimer en début et en fin d’une hypothèse.</p>
      </td>
    </tr>

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

      <td>
        <p>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 similaires à ceux de l’alphabet.</p>
      </td>
    </tr>

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

      <td>
        <p>Spécifie un ensemble d’orientations du texte reconnu pour lesquelles la recherche d’un élément est autorisée.</p>
      </td>
    </tr>
  </tbody>
</table>