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

# 文字列

> 仮説の作成、品質設定、文字セット、正規表現など、文字列要素のプロパティを設定します

| Parameter                                                                                                                                                              | 説明                                                                                                                                                                                                                                                                                                                                                                                                             |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Void AllowEmbeddedHypotheses( Logic )`                                                                                                                                | 仮説の生成モードを設定します。文字列から可能な限りすべての仮説 (重なりや入れ子を含む) を生成するには、値を **True** に設定します。最長の仮説のみを生成するには **False** に設定します。**例:** 次のコードは、このアクティビティが最も長い仮説を生成するよう指示します。`AllowEmbeddedHypotheses(False);`                                                                                                                                                                                                                           |
| `Void MinQuality( Real )`                                                                                                                                              | 仮説の最小品質を設定します。この最小品質を下回る仮説は破棄されます。**例:** 次のコードは、品質が 0.95 未満の仮説を無視するようアクティビティに指示します。`MinQuality: 0.95;`                                                                                                                                                                                                                                                                                                         |
| `Void MaxNonDefinedCount( Real )`                                                                                                                                      | 検索要素に対して指定されたどの文字セットにも属さない文字の許容割合を設定します。**例:** 次のコードは、文字列に指定された文字セット外の文字を最大 30% まで含んでもよいことをアクティビティに指示します。`MaxNonDefinedCount(0.3);`                                                                                                                                                                                                                                                                            |
| `Void MaxWordBreakCount( Real )`                                                                                                                                       | 行内の単語区切りの最大数を指定します。行は MinInterwordSpace パラメータに基づいて単語に分割されます。このパラメータは比率 (\[単語区切りの数]/\[文字列の文字数]) として指定します。                                                                                                                                                                                                                                                                                                       |
| `Void MinInterwordSpace( Distance )`                                                                                                                                   | スペース幅に基づいて行を単語に分割できるようにし、スペースの最小幅を Distance で指定します。                                                                                                                                                                                                                                                                                                                                                            |
| `Void WordsCount( Int, Int, Int, Int )`                                                                                                                                | 文字列内の単語数を設定します。単語数はファジー区間で指定します。既定の区間は `{-1,-1,INF,INF}` です (アクティビティは任意の単語数を含む仮説を検索します) 。                                                                                                                                                                                                                                                                                                                      |
| `Void TotalChainLength( Int, Int, Int, Int )`                                                                                                                          | 文字列の長さ (文字数) を設定します。文字数はファジー区間で指定します。**例:** 次のコードは、5〜10文字の長さの行を検索するようアクティビティに指示します。`TotalChainLength(4, 5, 10, 11);`                                                                                                                                                                                                                                                                                           |
| `Void TotalGapLength( Distance, Distance, Distance, Distance )`                                                                                                        | 文字列内のスペースの合計長の最大許容値をファジー区間として指定します。                                                                                                                                                                                                                                                                                                                                                                            |
| `Void MaxGapInLine( Distance )`                                                                                                                                        | 隣接文字間の最大距離を設定します。仮説を生成する際は、隣接する 2 文字間の距離が MaxGapInLine を超えなくなるまで、仮説に文字を追加します。                                                                                                                                                                                                                                                                                                                                  |
| `Void MaxRelativeGapInLine( Real )`                                                                                                                                    | 行の高さに対するパーセンテージとして指定される隣接文字間の最大距離を設定します。                                                                                                                                                                                                                                                                                                                                                                       |
| `Void AllowChoppedWords( Logic )`                                                                                                                                      | 左右の境界に完全には収まらないテキストオブジェクトを仮説に含めるかどうかを指定します。既定値は **True** です。                                                                                                                                                                                                                                                                                                                                                   |
| `Void MaxXOutsidePart( Real )`                                                                                                                                         | 水平方向において、検索領域の外側に出てもよいテキストオブジェクトの部分を指定します。この部分は 0 から 1 の数値で指定します。テキストオブジェクトのうち検索領域外にある部分がこのパラメータで指定した値以下であれば、そのテキストオブジェクトは仮説に含められます。                                                                                                                                                                                                                                                                           |
| `Void MaxYOutsidePart( Real )`                                                                                                                                         | 垂直方向において、検索領域の外側に出てもよいテキストオブジェクトの部分を指定します。この部分は 0 から 1 の数値で指定します。テキストオブジェクトのうち検索領域外にある部分がこのパラメータで指定した値以下であれば、そのテキストオブジェクトは仮説に含められます。                                                                                                                                                                                                                                                                           |
| `Void AddAlphabet( String alphabet, Real portion, Logic isRestrictionStrong )`                                                                                         | 文字セットと、仮説内で許容される文字の割合を設定します。フラグ isRestrictionStrong は、許容割合を超えた場合に仮説を破棄するかどうかを指定します。フラグが **False** の場合、超過した記号はどの文字セットにも属さないものとして扱われます。既定は **True** です。**例:** 次のコードは、№、#、%、\* から成る文字セットを追加し、仮説内での割合を 10% を超えないように指定します。**注意:** 現在の要素に対して指定済みのいずれの文字セットにも含まれない文字のみ追加できます。`AddAlphabet("№#%*", 0.1, True);`                                                                                                        |
| `Void RegularExpression( String )`                                                                                                                                     | 仮説のテキストを定義する正規表現を設定します。正規表現の構文は[こちら](/ja/vantage/documentation/advanced-designer/activities/extraction-rules/character-string#regular-expression)で説明されています。**例:** 次の 2 つの正規表現は同等で、文字の並びが次のいずれかになる文字列を検索します: 2 桁、- (ハイフン) 、1 桁、または N、1〜5 の数字、/ (スラッシュ) 、1〜3 桁。`RegularExpression: ("([0-9]{2}[-][0-9])\|([N][1-5][/][0-9]{1-3})");` `RegularExpression: ("([0-9]{2}\"-\"[0-9])\|(\"N\"[1-5]\"/\"[0-9]{1-3})");` |
| `Void WholeWordMode( Logic )`                                                                                                                                          | 完全な単語のみを有効な仮説として扱うかどうかを指定します。フラグが **True** の場合、単語の一部から成る仮説は破棄されます。既定は **False** です。**注意:** これは AllowedChoppedWords プロパティとは異なり、AllowChoppedWords は検索領域の境界上の単語のみを対象としますが、WholeWordMode は仮説内のすべての単語を対象とします。                                                                                                                                                                                                       |
| `Void RegularExpressionFromFile( String fileName, Int maxRecordsCount = 1000 )`                                                                                        | テキストファイルを使用して、仮説のテキストを定義する正規表現を設定します。fileName 引数でテキストファイル名を指定します。検索を高速化するため、先頭の maxRecordsCount 個の候補のみを使用します (既定は 1000) 。                                                                                                                                                                                                                                                                                      |
| `Void RegularExpressionFromCatalog( String catalogParameterName, Int columnIndex, NamedValueArray searchCriteria = EmptyNamedValueArray, Int maxRecordsCount = 1000 )` | catalogParameterName パラメータで参照されるデータ カタログの、インデックス columnIndex を持つ列の値を使用して、仮説のテキストを定義する正規表現を設定します。列インデックスは、次のいずれかのグローバル関数で取得できます: FieldNamesOfCatalog、GetCatalogColumnIndex、GetCatalogColumnIndices。レコードは、列名と想定値のペアからなる名前付き値の配列で指定した検索条件でフィルタリングできます。セットには、検索条件を満たすレコードの値のみが含まれます。クエリを高速化するため、先頭の maxRecordsCount 件のレコードのみを取得します (既定は 1000) 。                                                                    |
| `Void Width( Distance, Distance, Distance, Distance )`                                                                                                                 | 仮説の幅をファジー区間で指定します。                                                                                                                                                                                                                                                                                                                                                                                             |
| `Void Height( Distance, Distance, Distance, Distance )`                                                                                                                | 仮説の高さをファジー区間で指定します。                                                                                                                                                                                                                                                                                                                                                                                            |
| `Void TrimSymbols( String )`                                                                                                                                           | 仮説の先頭および末尾から削除する文字を指定します。                                                                                                                                                                                                                                                                                                                                                                                      |
| `Void SimilarSymbolQuality( Real )`                                                                                                                                    | 指定した文字セットの文字に形が似ている文字を仮説が含む場合に、仮説の品質に適用する係数を指定します。                                                                                                                                                                                                                                                                                                                                                             |
| `Void AllowedTextRotations( TextRotations )`                                                                                                                           | 認識されたテキストに対して許可する向きの集合を指定します。認識されたテキストの向きがこのパラメータで許可されている場合にのみ、仮説が生成されます。                                                                                                                                                                                                                                                                                                                                      |
