跳转到主要内容
下表中列出的函数只能在 搜索条件 部分使用。每个函数要么为搜索区域指定一个模糊矩形,要么将矩形添加到排除的矩形数组中。
函数说明
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 )将搜索区域限制为一个矩形,该矩形是页面的 Rectangle 与位于点 hyp.Right.Start + offset 右侧的垂直半平面相交所得的结果。示例: 查找位于元素 ElementName 右边界右侧、偏移量为 100 点的元素。如果未找到该元素,则改为将偏移量应用到该元素搜索区域的左(LEFT)边界。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 )将搜索区域限制为一个 Rectangle,该矩形是页面矩形与位于点 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 Parameter 只能取一个值:WholePage示例: 您可以指定只在最后一页上搜索该元素。RestrictSearchArea: WholePage, LastPage;
注意: 您可以使用 RSA 作为别名来代替全名 RestrictSearchArea
注意: 对同一页面设置的不同约束会联合生效,而对不同页面设置的约束则各自独立生效。(搜索仅在至少指定了一个约束的页面上执行。)

定义查找区域的辅助函数

FunctionDescription
Rect PageRect()当前页面在全局坐标中的矩形区域,用于指定依赖于页面的查找区域。PageRect 只能用于指定查找区域。示例: 若要指定某个元素位于页面的下半部分(事先不知道具体是哪一页),请写:Below: PageRect.Top + PageRect.Height / 2; 在其他所有情况下,请使用 Page( N ).Rect 来获取页码为 N 的页面矩形,或使用 DocumentRect 获取整个文档的矩形区域。还可以使用 PageNumber 函数来指定依赖于页面的查找区域。
Int PageNumber()当前页面的页码。用于指定依赖于页面的查找区域。示例: 假设有一个重复元素 SearchElements.PageHeader。要在每一页中位于该元素各实例下方的区域执行查找,请写:Below: SearchElements.PageHeader.AllInstances.PageAreaGlobal( PageNumber ).FuzzyRect, 0 * dot;