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

# Static Text

> Configurer les propriétés de l’élément Static Text dans FlexiLayout — qualité, tolérance aux erreurs, limites d’écart et de chevauchement, gestion de la casse et des diacritiques, et recherche de texte à partir de fichiers et de catalogues de données.

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

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

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

      <td>
        <p>Définit la qualité minimale de l’hypothèse.</p>
      </td>
    </tr>

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

      <td>
        <p>Définit le nombre maximal d’erreurs pour l’hypothèse.</p>
      </td>
    </tr>

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

      <td>
        <p>Définit le pourcentage maximal d’erreurs autorisé dans l’hypothèse.</p>
      </td>
    </tr>

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

      <td>
        <p>
          Définit le nombre maximal d’erreurs pour l’hypothèse : <em>number</em> – nombre absolu, <em>part</em> – pourcentage.
        </p>

        <details>
          <summary>Par ex.</summary>
          <p>Le code ci-dessous spécifie que le nombre absolu d’erreurs ne peut pas dépasser 3 et que le pourcentage d’erreurs ne peut pas dépasser 20 %.</p>

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

          <p>
            <strong>Remarque.</strong> Entre les deux conditions, l’activité appliquera la plus stricte.
          </p>
        </details>
      </td>
    </tr>

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

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

        <details>
          <summary>P. ex.</summary>
          <p>Le code ci-dessous indique à l’activité que la distance maximale entre caractères voisins 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>Définit la distance maximale entre deux caractères voisins, exprimée en pourcentage de la hauteur de ligne.</p>
      </td>
    </tr>

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

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

        <details>
          <summary>Par ex.</summary>
          <p>Le code ci-dessous indique à l’activité de rechercher l’élément uniquement parmi les objets texte qui s’inscrivent entièrement dans la zone de recherche.</p>

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

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

      <td>
        <p>
          Spécifie la partie de l'objet texte qui peut se trouver en dehors de la zone de recherche sur l'axe horizontal. Cette partie de l'objet texte est définie par un nombre compris entre 0 et 1. Un objet texte est
          inclus dans l'hypothèse si la partie de l'objet texte située en dehors de la zone de recherche ne dépasse pas la valeur spécifiée par ce paramètre.
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Spécifie la partie de l’objet Text qui peut se trouver en dehors de la zone de recherche sur l’axe vertical. Cette partie est exprimée par un nombre compris entre 0 et 1. Un objet Text est
          inclus dans l’Hypothesis si la partie de l’objet Text située en dehors de la zone de recherche ne dépasse pas la valeur spécifiée par ce Parameter.
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Distingue les lettres minuscules des majuscules lorsque ce paramètre est défini sur <strong>True</strong>.
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Ignore ou non les signes diacritiques lors de la recherche de texte. Si la valeur est définie sur <strong>True</strong>, les signes diacritiques seront ignorés (par exemple, les mots "café" et "cafe" seront considérés
          comme identiques).
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Spécifie l’ensemble des chaînes à rechercher dans une image à l’aide du fichier texte <em>fileName</em>. Pour plus d’informations sur l’utilisation des fichiers TXT, voir{" "}
          <a href="/fr/vantage/documentation/advanced-designer/activities/flexilayout/user-dictionaries">User Dictionaries</a> et{" "}
          <a href="/fr/vantage/documentation/advanced-designer/activities/extraction-rules/static-text">l’élément Static Text</a>.
        </p>

        <p>
          Pour accélérer la recherche, seules les <em>maxRecordsCount</em> premières variantes sont utilisées (la valeur par défaut est 1000).
        </p>

        <details>
          <summary>Ex.</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>
          Récupère les valeurs de la colonne d’indice <em>columnIndex</em> dans le catalogue de données référencé par le paramètre <em>catalogParameterName</em> et utilise ces valeurs comme ensemble de chaînes à
          rechercher dans une image. Vous pouvez déterminer les indices de colonne à l’aide de l’une des fonctions globales suivantes : FieldNamesOfCatalog, GetCatalogColumnIndex, GetCatalogColumnIndices.
        </p>

        <p>
          Les enregistrements peuvent être filtrés selon les critères de recherche définis à l’aide d’un tableau de valeurs nommées, où chaque valeur nommée représente le nom d’une colonne et la valeur attendue. L’ensemble de chaînes
          à rechercher ne contiendra que les valeurs des enregistrements qui satisfont aux critères de recherche.
        </p>

        <details>
          <summary>P. ex.</summary>
          <p>Le code ci-dessous indique à l’activité de rechercher les valeurs de la 2e colonne du catalogue de données référencé par le paramètre CompanyCatalog :</p>

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

          <p>
            Le code ci-dessous filtre les enregistrements en fonction de la valeur de la colonne "CompanyName". La valeur de la 2e colonne ne sera ajoutée au texte à rechercher que si la valeur de la colonne "CompanyName"
            pour l’enregistrement correspondant est "ABBYY".
          </p>

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

              <br />

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

          <p>Le code ci-dessous utilise une méthode auxiliaire, GetCatalogColumnIndex, pour obtenir l’indice de la colonne à partir de son nom :</p>

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

        <p>
          Pour accélérer la recherche, seuls les <em>maxRecordsCount</em> premiers enregistrements sont consultés (la valeur par défaut est 1000).
        </p>
      </td>
    </tr>

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

      <td>
        <p>Spécifie le pourcentage maximal autorisé de chevauchement vertical entre deux lignes de texte (la valeur par défaut est de 15). Ce paramètre peut être utile pour les textes à interligne serré.</p>
      </td>
    </tr>

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

      <td>
        <p>
          Indique le texte à rechercher dans une image. La chaîne peut contenir plusieurs variantes de recherche séparées par "|" (l’opérateur OR). Pour plus d’informations, voir{" "}
          <a href="/fr/vantage/documentation/advanced-designer/activities/extraction-rules/static-text">Propriétés spécifiques au type de l’élément Static Text</a>.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="2">
        <p>
          <em>Les méthodes suivantes sont disponibles si le texte à rechercher comporte plusieurs mots</em>
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Définit une pénalité pour les retours à la ligne. La pénalité est un nombre compris entre 0 et 1. La qualité de l’hypothèse sera multipliée par ce nombre autant de fois qu’il y a de retours à la ligne dans la phrase. Si
          les retours à la ligne sont autorisés dans la phrase, définissez ce paramètre sur 1 (multiplier la qualité de l’hypothèse par 1 n’en dégradera pas la qualité).
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Définit une pénalité pour les mots manquants. La pénalité est un nombre compris entre 0 et 1. La qualité de l’hypothèse sera multipliée par ce nombre autant de fois qu’il y a de mots manquants dans la phrase.
          Si certains mots peuvent être absents de la phrase, réglez ce paramètre sur 1 (multiplier la qualité de l’hypothèse par 1 n’en dégradera pas la qualité).
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Indique si seuls les objets texte entiers doivent être considérés comme des hypothèses valides. Lorsqu’elle est définie sur <strong>True</strong>, les hypothèses constituées de parties de mots sont ignorées. La valeur par défaut
          est <strong>False</strong>.
        </p>

        <p>
          <strong>Remarque.</strong> Cette méthode diffère de <strong>AllowChoppedWords</strong> en ce que <strong>AllowChoppedWords</strong> n’affecte que les hypothèses générées à partir des mots situés sur la
          limite de la zone de recherche, tandis que <strong>WholeWordMode</strong> affecte la génération de toutes les hypothèses.
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          Définit le mode de génération des hypothèses. Pour générer toutes les hypothèses possibles (y compris celles qui se chevauchent et celles qui sont imbriquées), définissez la valeur sur <strong>True</strong>. Pour générer des hypothèses de longueur
          maximale, définissez-la sur <strong>False</strong>.
        </p>

        <details>
          <summary>P. ex.</summary>
          <p>Le code ci-dessous indique à l’activité qu’elle doit générer l’hypothèse la plus longue.</p>

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

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

      <td>
        <p>Définit la distance horizontale entre les mots sur des lignes différentes si les sauts de ligne sont autorisés dans la phrase.</p>
      </td>
    </tr>

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

      <td>
        <p>
          Indique quels caractères l’activité peut utiliser comme caractères de remplacement lors d’une recherche approchée. Lorsque cette valeur est définie sur <strong>True</strong>, l’activité est limitée à l’utilisation de seuls caractères ayant
          une forme similaire comme caractères de remplacement.
        </p>
      </td>
    </tr>

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

      <td>
        <p>Spécifie un ensemble d’orientations autorisées pour le texte reconnu. Une hypothèse n’est formulée que si l’orientation du texte reconnu est autorisée par ce paramètre.</p>
      </td>
    </tr>
  </tbody>
</table>