> ## 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.
# 検索範囲を制限する関数
> Search Conditions セクションでファジーな Rectangle を指定し、検索範囲を制限する関数のリファレンス。
以下の表に挙げる関数は、**Search Conditions** セクションでのみ使用できます。各関数は検索範囲用のファジーな Rectangle を指定するか、除外対象の Rectangle 配列に Rectangle を追加します。
| 関数 | 説明 |
| :-------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Void LeftOf( XInterval x, Distance offset = 0 )` | 検索領域を、ページの矩形と点 `x.End - offset` の左側に位置する垂直半平面との交差によって得られる矩形に制限します。 |
| `Void LeftOf( FuzzyRect fuzzyRect, Distance offset = 0 )` | 検索領域を、点 `fuzzyRect.Left.End – offset` の左側の垂直半平面で制限します。 |
| `Void LeftOf( Hypothesis hyp, Distance offset = 0 )` | 検索領域を、ページの矩形と点 `hyp.Left.End - offset` の左側に位置する垂直半平面との交差によって得られる矩形に制限します。 |
| `Void LeftOf( HypothesisInstances hyps, Distance offset = 0 )` | 検索領域を、点 `hyp.Left.End – offset` の左側の垂直半平面で制限します。グローバル座標が使用されます。 |
| `Void RightOf( XInterval x, Distance offset = 0 )` | 検索領域を、ページの矩形と点 `x.Start + offset` の右側に位置する垂直半平面との交差によって得られる矩形に制限します。 |
| `Void RightOf( FuzzyRect fuzzyRect, Distance offset = 0 )` | 検索領域を、点 `hyp.Right.Start + offset` の右側の垂直半平面で制限します。**例:** ファジー矩形Element1とElement2の交差部分の右側にある要素を検索します。`FuzzyRect intersection = Element1.FuzzyRect AND Element2.FuzzyRect; RightOf: intersection;` |
| `Void RightOf( Hypothesis hyp, Distance offset = 0 )` | 検索領域を、ページの矩形と点 `hyp.Right.Start + offset` の右側に位置する垂直半平面との交差によって得られる矩形に制限します。**例:** ElementName要素の右境界の右側に、100ドットのオフセットで要素を検索します。要素が見つからない場合、オフセットは代わりに要素の検索領域の左境界に適用されます。`RightOf: ElementName.Right, 100dt;` |
| `Void RightOf( HypothesisInstances hyps, Distance offset = 0 )` | 検索領域を、点 `hyp.Right.Start + offset` の右側の垂直半平面で制限します。グローバル座標が使用されます。 |
| `Void Above( YInterval y, Distance offset = 0 )` | 検索領域を、ページの矩形と点 `y.End - offset` の上側に位置する水平半平面との交差によって得られる矩形に制限します。 |
| `Void Above( FuzzyRect fuzzyRect, Distance offset = 0 )` | 検索領域を、点 `hyp.Top.End – offset` の上側の水平半平面で制限します。 |
| `Void Above( Hypothesis hyp, Distance offset = 0 )` | 検索領域を、ページの矩形と点 `hyp.Top.End - offset` の上側に位置する水平半平面との交差によって得られる矩形に制限します。 |
| `Void Above( HypothesisInstances hyps, Distance offset = 0 )` | 検索領域を、点 `hyp.Top.End – offset` の上側の水平半平面で制限します。グローバル座標が使用されます。 |
| `Void Below( YInterval y, Distance offset = 0 )` | 検索領域を、ページの矩形と点 `y.Start + offset` の下側に位置する水平半平面との交差によって得られる矩形に制限します。 |
| `Void Below( FuzzyRect fuzzyRect, Distance offset = 0 )` | 検索領域を、点 `hyp.Bottom.Start + offset` の下側の水平半平面で制限します。 |
| `Void Below( Hypothesis hyp, Distance offset = 0 )` | 検索領域を、ページの矩形と点 `hyp.Bottom.Start + offset` の下側に位置する水平半平面との交差によって得られる矩形に制限します。 |
| `Void Below( HypothesisInstances hyps, Distance offset = 0 )` | 検索領域を、点 `hyp.Bottom.Start + offset` の下側の水平半平面で制限します。グローバル座標が使用されます。 |
| `Void Exclude( Hypothesis hyp )` | hyp仮説の領域を検索領域から除外します。hyp仮説が見つからない場合、hyp仮説の検索領域の内部矩形を除外します。**例:** プログラムにElementName要素を検索領域から除外するよう指示します。ElementNameが見つからない場合、この関数を呼び出しても検索領域は変更されません。`Exclude: ElementName;` |
| `Void Exclude( Rect rect )` | rect矩形を検索領域から除外します。**例:** プログラムにElementName要素の矩形を除外するよう指示します。ElementNameが見つからない場合、この関数を呼び出すとElementNameの検索領域が現在の要素の検索領域から除外されます。`Exclude: ElementName.Rect;` |
| `Void Exclude( RectArray rectArray )` | rectArray矩形配列を検索領域から除外します。**例:** プログラムに要素ElementName1、ElementName2、ElementName3の矩形を除外するよう指示します。これらの要素のいずれかが検出されない場合、この関数を呼び出すと、それらの検索領域が現在の要素の検索領域から除外されます。`Exclude: RectArray(ElementName1.Rect or ElementName2.Rect or ElementName3.Rect);` |
| `Void ExcludeRect( XInterval left, YInterval top, XInterval right, YInterval bottom )` | 範囲left、top、right、bottomで記述されたファジー矩形を検索領域から除外します。**例:** プログラムに絶対サイズの矩形 left = 10 dot、top= 200 dot、right=100 dot、bottom=400 dotを検索領域から除外するよう指示します。`ExcludeRect: 10dt, 200dt, 100dt, 400dt;` |
| `Void ExcludeSet( ImageObjectSet set )` | \_set\_オブジェクトセットの矩形配列を検索領域から除外します。**例:** プログラムに要素ElementNameのオブジェクト配列を現在の要素の検索領域から除外するよう指示します。`ExcludeSet: ElementName.Set;` |
| `Void Exclude( HypothesisInstances )` | 仮説のインスタンスの領域を検索領域から除外します。 |
| `Void RestrictSearchArea( FuzzyRect fuzzyRect )` | 検索領域をファジー矩形fuzzyRectに制限します。グローバル座標が使用されます。 |
| `Void RestrictSearchArea( FuzzyRect, IntArray pages )` | 検索領域をファジー矩形fuzzyRectで制限します。ローカル座標とページ範囲pagesを指定します。 |
| `Void RestrictSearchArea( FuzzyRect, SearchAreaPageSetType )` | 検索領域をファジー矩形fuzzyRectで制限します。ローカル座標とSearchAreaPageSetType型のページ範囲を指定します。 |
| `Void RestrictSearchArea( RectArray rectArray )` | 検索領域を矩形配列rectArrayに制限します。グローバル座標が使用されます。**例:** 現在の要素の検索領域の境界が、要素ElementName1、ElementName2、ElementName3の矩形の境界によって定義されるように指定できます。いずれかの要素が検出されない場合、この関数にアクセスすると、現在の要素の検索領域は対応する要素の検索領域の境界によって定義されます。`RestrictSearchArea: RectArray(ElementName1.Rect or ElementName2.Rect or ElementName3.Rect);` |
| `Void RestrictSearchArea( RectArray, IntArray pages )` | 検索領域を矩形配列rectArrayで制限します。ローカル座標とページ範囲pagesを指定します。 |
| `Void RestrictSearchArea( RectArray, SearchAreaPageSetType )` | 検索領域を矩形配列rectArrayで制限します。ローカル座標とSearchAreaPageSetType型のページ範囲を指定します。 |
| `Void RestrictSearchArea( Region region )` | 検索領域を領域regionに制限します。グローバル座標が使用されます。**例:** 現在の要素の検索領域が要素ElementNameの領域によって制限されるように指定できます。`RestrictSearchArea: ElementName.Region;` |
| `Void RestrictSearchArea( Region, IntArray pages )` | 検索領域を領域で制限します。ローカル座標とページ範囲pagesを指定します。 |
| `Void RestrictSearchArea( Region, SearchAreaPageSetType )` | 領域によって検索エリアを制限します。SearchAreaPageSetType型のローカル座標とページ範囲を指定します。**例:** 偶数ページの検索エリア内で要素を検索するように指定できます。`RestrictSearchArea: searchArea, EvenPages;` |
| `Void RestrictSearchArea( SearchAreaPageRestriction pageRestriction, IntArray pages )` | ページ自体の検索エリアを制限せずに、検索対象のページ範囲を制限します。pageRestrictionパラメータは唯一の値WholePageを取ります。**例:** ページ2、4、7-9で要素を検索するように指定できます。`RestrictSearchArea: WholePage, 2 << 4 << 7 << 8 << 9;` |
| `Void RestrictSearchArea( SearchAreaPageRestriction pageRestriction, SearchAreaPageSetType )` | ページ自体の検索エリアを制限せずに、検索対象のページ範囲を制限します。pageRestrictionパラメータは唯一の値WholePageを取ります。**例:** 最後のページで要素を検索するように指定できます。`RestrictSearchArea: WholePage, LastPage;` |
フルネーム **RestrictSearchArea** の代わりに、エイリアス **RSA** を使用できます。
同じページに対する複数の制約は併用され、異なるページの制約は独立して適用されます。 (検索は、少なくとも1つの制約が指定されているページで実行されます。)
## 検索範囲を定義する補助関数
| Function | Description |
| :----------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Rect PageRect()` | ページに依存する検索範囲を指定するために使用される、グローバル座標での現在のページの矩形。**PageRect** は検索範囲の指定にのみ使用できます。**例:** 要素がページの下半分にある（正確なページは事前には不明）ことを指定するには、次のように記述します: `Below: PageRect.Top + PageRect.Height / 2;` それ以外の場合は、ページ番号 **N** のページ矩形を取得するには **Page( N ).Rect**、文書全体の矩形を取得するには **DocumentRect** を使用してください。ページに依存する検索範囲を指定するには **PageNumber** 関数を使用することもできます。 |
| `Int PageNumber()` | 現在のページ番号。ページに依存する検索範囲を指定します。**例:** 繰り返し要素 SearchElements.PageHeader があるとします。各ページでこの要素の各インスタンスの下を検索するには、次のように記述します: `Below: SearchElements.PageHeader.AllInstances.PageAreaGlobal( PageNumber ).FuzzyRect, 0 * dot;` |