跳轉到主要內容
下表列出的函式只能在 搜尋條件 區段中使用。每個函式會為搜尋區域指定一個模糊矩形區域,或將矩形新增到排除矩形陣列中。
函式描述
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 )將搜尋區域限制為一個 Rectangle,此 Rectangle 為頁面的 Rectangle 與位於點 x.Start + offset 右側的垂直半平面相交所得的結果。
Void RightOf( FuzzyRect fuzzyRect, Distance offset = 0 )將搜尋區域限制為位於點 hyp.Right.Start + offset 右側的垂直半平面。**範例:**在模糊 Rectangle Element1 與 Element2 的交集右側搜尋元素。FuzzyRect intersection = Element1.FuzzyRect AND Element2.FuzzyRect; RightOf: intersection;
Void RightOf( Hypothesis hyp, Distance offset = 0 )將搜尋區域限制為一個矩形,此矩形為頁面矩形與位於點 hyp.Right.Start + offset 右側的垂直半平面之交集。**範例:**在 ElementName 元素右邊界右側,以 100 dots 的偏移量搜尋元素。若找不到該元素,則會將偏移量套用至該元素搜尋區域的 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 )將搜尋區域限制為一個 Rectangle,該 Rectangle 為頁面矩形與位於點 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 )將搜尋區域限制為一個 Rectangle,此矩形為頁面矩形與位於點 hyp.Bottom.Start + offset 以下的水平半平面的交集結果。
Void Below( HypothesisInstances hyps, Distance offset = 0 )將搜尋區域限制為位於點 hyp.Bottom.Start + offset 以下的水平半平面。使用全域座標系。
Void Exclude( Hypothesis hyp )從搜尋區域中排除 hyp 假設所覆蓋的區域。若找不到 hyp 假設,則從該假設的搜尋區域中排除其內部矩形。範例: 指示程式將 ElementName 元素從搜尋區域中排除。若未找到 ElementName,呼叫此函式將不會修改搜尋區域。Exclude: ElementName;
Void Exclude( Rect rect )從搜尋區域中排除 rect 所指定的矩形。範例: 指示程式將 ElementName 元素的矩形排除在搜尋區域之外。如果找不到 ElementName,呼叫此函式時,會將 ElementName 的搜尋區域自目前元素的搜尋區域中排除。Exclude: ElementName.Rect;
Void Exclude( RectArray rectArray )從搜尋區域中排除 rectArray 陣列中的 Rectangle。範例: 指示程式排除元素 ElementName1、ElementName2 和 ElementName3 的 Rectangle。若未偵測到其中任一元素,在呼叫此函式時,這些元素的搜尋區域將會從目前元素的搜尋區域中排除。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 點、top = 200 點、right = 100 點、bottom = 400 點的矩形。ExcludeRect: 10dt, 200dt, 100dt, 400dt;
Void ExcludeSet( ImageObjectSet set )從搜尋區域中排除 set 物件集合中的 Rectangle 陣列。範例: 指示程式從目前元素的搜尋區域中排除元素 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 Parameter 只能取一種值: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;