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

> FlexiLayout で Static Text 要素のプロパティを設定します。品質、エラー許容度、ギャップとオーバーラップの制限、大文字と小文字や発音区別符号の扱い、ファイルおよびデータ カタログからのテキスト検索を構成できます。

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

      <td>
        <p>
          <strong>説明</strong>
        </p>
      </td>
    </tr>

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

      <td>
        <p>候補の最小品質を設定します。</p>
      </td>
    </tr>

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

      <td>
        <p>仮説のエラーの最大数を設定します。</p>
      </td>
    </tr>

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

      <td>
        <p>認識候補に含まれるエラーの最大割合を設定します。</p>
      </td>
    </tr>

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

      <td>
        <p>
          認識候補内のエラーの最大数を設定します: <em>number</em> – 絶対数、<em>part</em> – パーセンテージ。
        </p>

        <details>
          <summary>例</summary>
          <p>以下のコードは、エラーの絶対数は 3 を超えず、エラー率は 20% を超えないよう指定しています。</p>

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

          <p>
            <strong>注。</strong> 2 つの条件のうち、アクティビティではより厳しい方が適用されます。
          </p>
        </details>
      </td>
    </tr>

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

      <td>
        <p>隣接する文字間の最大距離を設定します。</p>
        <p>仮説の生成時、隣接する 2 つの文字間の距離が MaxGapInLine を超えない限り、アクティビティは文字を仮説に追加します。</p>

        <details>
          <summary>例</summary>
          <p>以下のコードは、隣接する文字間の最大距離を 5 mm に設定し、これを超えた場合はヌル仮説を生成するようアクティビティに指示します。</p>

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

    <tr>
      <td>
        <p>Void MaxRelativeGapInLine( 実数 )</p>
      </td>

      <td>
        <p>隣接する文字間の最大距離を、行の高さに対する比率 (パーセンテージ) で設定します。</p>
      </td>
    </tr>

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

      <td>
        <p>
          このフラグは、左右の境界内に完全には収まらないテキストオブジェクトを認識候補に含めるかどうかを指定します。デフォルト値は<strong>True</strong>です。
        </p>

        <details>
          <summary>例</summary>
          <p>以下のコードは、検索領域内に完全に収まるテキストオブジェクトだけを対象に要素を検索するようアクティビティに指示します。</p>

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

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

      <td>
        <p>
          水平方向で、検索領域の外側にあってもよいTextオブジェクトの割合を指定します。Textオブジェクトの割合は、0 から 1 までの数値で指定します。検索領域の外側にあるTextオブジェクトの割合がこのParameterで指定した値以下であれば、そのTextオブジェクトは
          仮説に含まれます。
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          垂直方向において、テキストオブジェクトのうち検索領域の外側にはみ出してもよい割合を指定します。テキストオブジェクトの割合は、0 から 1 までの数値で指定します。検索領域の外側にあるテキストオブジェクトの割合がこの Parameter で指定した値以下であれば、そのテキストオブジェクトは
          仮説に含まれます。
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          <strong>True</strong> に設定すると、大文字と小文字を区別します。
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          テキスト検索時に発音区別符号を無視するかどうかを指定します。値が <strong>True</strong> に設定されている場合、発音区別符号は無視されます (たとえば、"café" と "cafe" は同じものとして扱われます) 。
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          テキストファイル <em>fileName</em> を使用して、画像上で検索する文字列のセットを指定します。TXT ファイルの使用方法について詳しくは、{" "}
          <a href="/ja/vantage/documentation/advanced-designer/activities/flexilayout/user-dictionaries">ユーザー辞書</a> と{" "}
          <a href="/ja/vantage/documentation/advanced-designer/activities/extraction-rules/static-text">静的テキスト要素</a> を参照してください。
        </p>

        <p>
          検索を高速化するため、最初の <em>maxRecordsCount</em> 件の候補のみが使用されます (デフォルトは 1000 です) 。
        </p>

        <details>
          <summary>例</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>
          <em>catalogParameterName</em> パラメーターで参照されるデータ カタログの <em>columnIndex</em> で指定した列から値を取得し、その値を画像内で検索する文字列セットとして使用します。列インデックスは、次のいずれかのグローバル関数を使用して取得します: FieldNamesOfCatalog、GetCatalogColumnIndex、GetCatalogColumnIndices。
        </p>

        <p>
          レコードは、名前付き値の配列で指定した検索条件に基づいてフィルターできます。各名前付き値は、列名とその期待値を表します。検索対象の文字列セットには、検索条件を満たすレコードの値のみが含まれます。
        </p>

        <details>
          <summary>例</summary>
          <p>次のコードは、CompanyCatalog パラメーターで参照されるデータ カタログの 2 列目の値を検索するようアクティビティに指示します:</p>

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

          <p>
            次のコードは、"CompanyName" 列の値に基づいてレコードをフィルターします。対応するレコードの "CompanyName" 列の値が "ABBYY" の場合にのみ、2 列目の値が検索対象のテキストに追加されます。
          </p>

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

              <br />

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

          <p>次のコードは、補助メソッド GetCatalogColumnIndex を使用して列名から列インデックスを取得します:</p>

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

        <p>
          クエリを高速化するため、参照されるのは先頭の <em>maxRecordsCount</em> 件のレコードのみです (既定値は 1000) 。
        </p>
      </td>
    </tr>

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

      <td>
        <p>2 行のテキストが縦方向に重なることを許容する最大割合を指定します (既定値は 15) 。行間の狭いテキストでは、このパラメーターを使用すると便利な場合があります。</p>
      </td>
    </tr>

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

      <td>
        <p>
          画像内で検索するテキストを指定します。string には、"|" (OR 演算子) で区切られた複数の検索候補を含めることができます。詳細については、{" "}
          <a href="/ja/vantage/documentation/advanced-designer/activities/extraction-rules/static-text">Static Text 要素の型別プロパティ</a>を参照してください。
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="2">
        <p>
          <em>検索対象のテキストが複数の単語で構成されている場合、以下のメソッドを使用できます</em>
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          改行に対するペナルティを設定します。ペナルティは 0 から 1 までの数値です。仮説の品質には、フレーズ内の改行数に応じて、この数値がその回数分乗算されます。フレーズ内で
          改行を許可する場合は、このパラメーターを 1 に設定します (仮説の品質に 1 を乗算しても、品質は低下しません) 。
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          欠落した単語に対するペナルティを設定します。ペナルティは 0 から 1 の数値です。認識候補の品質には、フレーズ内で欠落している単語の数だけ、この数値が繰り返し乗算されます。
          フレーズ内で一部の単語が欠落していても問題ない場合は、このパラメーターを 1 に設定してください (認識候補の品質に 1 を乗算しても、品質は低下しません) 。
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          有効な仮説として考慮する対象を、完全なテキストオブジェクトのみにするかどうかを指定します。<strong>True</strong> に設定すると、単語の一部から成る仮説は無視されます。既定の設定
          は <strong>False</strong> です。
        </p>

        <p>
          <strong>注：</strong>このメソッドは <strong>AllowChoppedWords</strong> とは異なります。<strong>AllowChoppedWords</strong> は検索領域の
          境界上にある単語から生成される仮説にのみ影響しますが、<strong>WholeWordMode</strong> はすべての仮説の生成に影響します。
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          仮説の生成モードを設定します。可能なすべての仮説 (重複するものや入れ子になったものを含む) を生成するには、値を <strong>True</strong> に設定します。最長の仮説のみを生成するには、<strong>False</strong> に設定します。
        </p>

        <details>
          <summary>例</summary>
          <p>以下のコードは、アクティビティに最長の仮説を生成するよう指定しています。</p>

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

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

      <td>
        <p>フレーズ内で改行が許可されている場合、別の行にある単語同士の水平方向の距離を設定します。</p>
      </td>
    </tr>

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

      <td>
        <p>
          あいまい検索を実行する際に、アクティビティが置換文字として使用できる文字を指定します。<strong>True</strong>に設定すると、アクティビティは置換文字として形状が似た文字のみを使用するように制限されます。
        </p>
      </td>
    </tr>

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

      <td>
        <p>認識されたテキストに対して許可する向きのセットを指定します。認識されたテキストの向きがこのパラメーターで許可されている場合にのみ、仮説が生成されます。</p>
      </td>
    </tr>
  </tbody>
</table>