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

# 文字列

> FlexiLayout languageで、アルファベット、正規表現、品質の制限、単語数、ギャップ制約などの文字列要素のプロパティを設定します。

FlexiLayout language の **文字列** 要素では、次のパラメーターを使用できます。

<div id="character-string-parameters">
  ## 文字列のパラメーター
</div>

| Parameter                                                                                                  | 説明                                                                                                                                                                                                                                                                                                 |
| ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Void AllowEmbeddedHypotheses( Logic )`                                                                    | [**文字列**](/ja/flexi-capture/fls/template/character-chain)、**埋め込み仮説の許可**を参照してください。                                                                                                                                                                                                                  |
| `Void MinQuality( Real )`                                                                                  | 仮説の最小品質を設定します。この最小値を下回る品質の仮説は破棄されます。                                                                                                                                                                                                                                                               |
| `Void MaxNonDefinedCount( Real )`                                                                          | [**Character String**](/ja/flexi-capture/fls/template/character-chain)の**アルファベット以外の文字の割合**を参照してください。                                                                                                                                                                                               |
| `Void MaxWordBreakCount( Real )`                                                                           | 行内の単語の区切りの最大数です。行は **Detect words by interword space** パラメーターに基づいて単語に分割されます (**要素のプロパティ** ダイアログの [**Character String**](/ja/flexi-capture/fls/template/character-chain) タブを参照) 。このパラメーターは、`[number of word ends]/[number of characters in the string]` の比率で指定します。                                  |
| `Void MinInterwordSpace( Distance )`                                                                       | スペースの幅に基づいて単語に分割できるようにし (**要素のプロパティ**ダイアログの [**Character String**](/ja/flexi-capture/fls/template/character-chain) タブにある **単語間スペースで単語を検出** を参照) 、スペースの最小幅を `Distance` で指定します (**Min interword space** パラメーター) 。                                                                                    |
| `Void WordsCount( Int, Int, Int, Int )`                                                                    | **要素のプロパティ** ダイアログの [**Character String**](/ja/flexi-capture/fls/template/character-chain) タブにある **単語数** を参照してください。                                                                                                                                                                                |
| `Void TotalChainLength( Int, Int, Int, Int )`                                                              | [**文字列**](/ja/flexi-capture/fls/template/character-chain)、**文字数**を参照してください。                                                                                                                                                                                                                        |
| `Void TotalGapLength( Distance, Distance, Distance, Distance )`                                            | 文字列内の空白の合計長の許容最大値を、[ファジー区間](/ja/flexi-capture/fls/template/fuzzy-interval)として指定します。仮説の品質は、空白の合計長に基づいて評価されます。                                                                                                                                                                                       |
| `Void MaxGapInLine( Distance )`                                                                            | 隣接する文字間の最大距離を設定します。仮説を生成する際、2 つの隣接する文字間の距離が `MaxGapInLine` を超えない限り、FlexiLayout Studio はその仮説に文字を追加します。関連項目: [**文字列**](/ja/flexi-capture/fls/template/character-chain)、**最大空白長**。                                                                                                                    |
| `Void MaxRelativeGapInLine( Real )`                                                                        | 隣接する文字間の最大距離を、行の高さに対する割合で指定します。                                                                                                                                                                                                                                                                    |
| `Void AllowChoppedWords( Logic )`                                                                          | このフラグは、左右の境界内に完全に収まっていないテキストオブジェクトを仮説に含めるかどうかを指定します。デフォルト値は `true` です。                                                                                                                                                                                                                             |
| `Void MaxXOutsidePart( Real )`                                                                             | 文字のうち、水平方向で検索領域の外にはみ出してよい部分を指定します。文字の部分は、`0` から `1` までの数値で指定します。検索領域の外にはみ出している部分が指定した値以下の文字は、認識候補に含まれます。                                                                                                                                                                                           |
| `Void MaxYOutsidePart( Real )`                                                                             | 文字のうち、検索領域から垂直方向にはみ出してもよい部分を指定します。文字の部分は、`0` から `1` までの数値で指定します。検索領域の外側にある部分が指定した値以下の文字は、Hypothesis に含まれます。                                                                                                                                                                                        |
| `Void AddAlphabet( String alphabet, Real portion, Logic isRestrictionStrong )`                             | 仮説で使用するアルファベットと、仮説内で許容されるアルファベット文字の割合を設定します。`isRestrictionStrong` フラグは、許容されるアルファベット文字の割合を超えた仮説を有効と見なすかどうかを指定します。フラグが `true` に設定されている場合、許容される割合を超えた仮説は除外されます。フラグが `false` に設定されている場合、超過した文字はいずれのアルファベットにも属さないものと見なされます。既定値は `true` です。                                                              |
| `Void RegularExpression( String )`                                                                         | 仮説のテキストを定義する正規表現を設定します。                                                                                                                                                                                                                                                                            |
| `Void WholeWordMode ( Logic )`                                                                             | このフラグは、有効な仮説として単語全体のみを考慮するかどうかを指定します。フラグが `true` に設定されている場合、単語の一部から成る仮説は破棄されます。既定値は `false` です。**注:** このプロパティは `AllowChoppedWords` とは異なります。`AllowChoppedWords` は検索領域の境界にある単語から成る仮説の生成にのみ影響するのに対し、`WholeWordMode` はすべての仮説の生成に影響します。                                                                 |
| `Void RegularExpressionFromDB( String connectionString, String selectString, Int maxRecordsCount = 1000 )` | データベースを使用して、仮説のテキストを定義する正規表現を設定します。詳細は、[FlexiLayout language でのデータベースとテキストファイル](/ja/flexi-capture/fls/language/bd-textfiles)を参照してください。`connectionString` 引数では、データベース接続用の文字列を設定します。`selectString` 引数では、`SELECT` コマンドで始まる SQL クエリを設定します。検索を高速化するため、最初の `maxRecordsCount` 件の候補のみが使用されます (既定値は 1000) 。 |
| `Void RegularExpressionFromFile( String fileName, Int maxRecordsCount = 1000 )`                            | テキストファイルを使用して、仮説のテキストを定義する正規表現を設定します。詳細については、[FlexiLayout language でのデータベースとテキストファイル](/ja/flexi-capture/fls/language/bd-textfiles)を参照してください。`fileName` 引数では、テキストファイル名を指定します。検索を高速化するため、使用される候補は先頭の `maxRecordsCount` 件のみです (デフォルト設定は 1000 です) 。                                                    |
| `Void Width( Distance, Distance, Distance, Distance )`                                                     | 認識候補の幅を[ファジー区間](/ja/flexi-capture/fls/template/fuzzy-interval)で指定します。                                                                                                                                                                                                                              |
| `Void Height( Distance, Distance, Distance, Distance )`                                                    | [ファジー区間](/ja/flexi-capture/fls/template/fuzzy-interval)で指定する候補の高さです。                                                                                                                                                                                                                               |
| `Void TrimSymbols( String )`                                                                               | 仮説の先頭および末尾でトリミングする文字を指定します。                                                                                                                                                                                                                                                                        |
| `Void SimilarSymbolQuality( Real )`                                                                        | アルファベット内の文字に似た文字のリストに含まれる文字が仮説に含まれている場合に、その仮説の品質に掛ける係数を指定します。                                                                                                                                                                                                                                      |
| `Void AllowedTextRotations ( TextRotations )`                                                              | 要素検索を許可する認識されたテキストの向きのセットを指定します。                                                                                                                                                                                                                                                                   |

<div id="parameter-examples">
  ## Parameter の例
</div>

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

次のコードは、最も長い仮説を生成するよう FlexiLayout Studio に指示します。

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

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

次のコードは、品質が 0.95 未満の仮説を無視するよう FlexiLayout Studio に指示します。

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

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

次のコードは、指定されたどのアルファベットにも属さない文字を、文字列に最大 30% まで含められることを FlexiLayout Studio に示しています。

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

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

次のコードは、長さが 5 ～ 10 文字の行を探すよう FlexiLayout Studio に指示します。

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

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

次のコードは、隣接する文字間の最大距離を 5 mm 以下に設定し、これを超える場合はヌル仮説を生成するよう FlexiLayout Studio に指示します。

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

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

次のコードは、文字 №、#、%、および `*` から成るアルファベットを追加し、その仮説における割合が 10% を超えないように FlexiLayout Studio に指定しています。

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

<Note>
  現在の要素に指定されているどのアルファベットにも含まれていない文字だけを追加できます。
</Note>

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

次の 正規表現 は、文字が次の2通りのいずれかの形式で並ぶ 文字列 を検索します。1つは、2桁の数字、ハイフン (`-`) 、1桁の数字。もう1つは、文字 `N`、1〜5 の数字、スラッシュ (`/`) 、1〜3 桁の数字です。

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

これは次と同じです:

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