Vai al contenuto principale
Le funzioni elencate nella tabella seguente possono essere utilizzate solo nella sezione Search Conditions. Ciascuna funzione definisce un rettangolo fuzzy per l’area di ricerca oppure aggiunge dei rettangoli a un array di rettangoli esclusi.
FunzioneDescrizione
Void LeftOf( XInterval x, Distance offset = 0 )Limita l’area di ricerca a un rettangolo risultante dall’intersezione del rettangolo della Pagina con il semipiano verticale situato a sinistra del punto x.End - offset.
Void LeftOf( FuzzyRect fuzzyRect, Distance offset = 0 )Limita l’area di ricerca con il semipiano verticale a sinistra del punto fuzzyRect.Left.End – offset.
Void LeftOf( Hypothesis hyp, Distance offset = 0 )Limita l’area di ricerca a un rettangolo risultante dall’intersezione del rettangolo della Pagina con il semipiano verticale situato a sinistra del punto hyp.Left.End - offset.
Void LeftOf( HypothesisInstances hyps, Distance offset = 0 )Limita l’area di ricerca con il semipiano verticale a sinistra del punto hyp.Left.End – offset. Vengono usate le coordinate globali.
Void RightOf( XInterval x, Distance offset = 0 )Limita l’area di ricerca a un rettangolo risultante dall’intersezione del rettangolo della Pagina con il semipiano verticale situato a destra del punto x.Start + offset.
Void RightOf( FuzzyRect fuzzyRect, Distance offset = 0 )Limita l’area di ricerca con il semipiano verticale a destra del punto hyp.Right.Start + offset. Esempio: Cerca l’elemento a destra dell’intersezione dei FuzzyRect di Element1 ed Element2. FuzzyRect intersection = Element1.FuzzyRect AND Element2.FuzzyRect; RightOf: intersection;
Void RightOf( Hypothesis hyp, Distance offset = 0 )Limita l’area di ricerca a un rettangolo risultante dall’intersezione del rettangolo della Pagina con il semipiano verticale situato a destra del punto hyp.Right.Start + offset. Esempio: Cerca l’elemento a destra del bordo destro dell’elemento ElementName con un offset di 100 dot. Se l’elemento non viene trovato, l’offset verrà applicato al bordo SINISTRO dell’area di ricerca dell’elemento. RightOf: ElementName.Right, 100dt;
Void RightOf( HypothesisInstances hyps, Distance offset = 0 )Limita l’area di ricerca con il semipiano verticale a destra del punto hyp.Right.Start + offset. Vengono usate le coordinate globali.
Void Above( YInterval y, Distance offset = 0 )Limita l’area di ricerca a un rettangolo risultante dall’intersezione del rettangolo della Pagina con il semipiano orizzontale situato al di sopra del punto y.End - offset.
Void Above( FuzzyRect fuzzyRect, Distance offset = 0 )Limita l’area di ricerca con il semipiano orizzontale al di sopra del punto hyp.Top.End – offset.
Void Above( Hypothesis hyp, Distance offset = 0 )Limita l’area di ricerca a un rettangolo risultante dall’intersezione del rettangolo della Pagina con il semipiano orizzontale situato al di sopra del punto hyp.Top.End - offset.
Void Above( HypothesisInstances hyps, Distance offset = 0 )Limita l’area di ricerca con il semipiano orizzontale al di sopra del punto hyp.Top.End – offset. Vengono usate le coordinate globali.
Void Below( YInterval y, Distance offset = 0 )Limita l’area di ricerca a un rettangolo risultante dall’intersezione del rettangolo della Pagina con il semipiano orizzontale situato al di sotto del punto y.Start + offset.
Void Below( FuzzyRect fuzzyRect, Distance offset = 0 )Limita l’area di ricerca con il semipiano orizzontale al di sotto del punto hyp.Bottom.Start + offset.
Void Below( Hypothesis hyp, Distance offset = 0 )Limita l’area di ricerca a un rettangolo risultante dall’intersezione del rettangolo della Pagina con il semipiano orizzontale situato al di sotto del punto hyp.Bottom.Start + offset.
Void Below( HypothesisInstances hyps, Distance offset = 0 )Limita l’area di ricerca con il semipiano orizzontale al di sotto del punto hyp.Bottom.Start + offset. Vengono usate le coordinate globali.
Void Exclude( Hypothesis hyp )Esclude dall’area di ricerca la regione dell’ipotesi hyp. Se l’ipotesi hyp non viene trovata, esclude il rettangolo interno dell’area di ricerca dell’ipotesi hyp. Esempio: Istruisci il programma a escludere l’elemento ElementName dall’area di ricerca. Se ElementName non viene trovato, la chiamata a questa funzione non modificherà l’area di ricerca. Exclude: ElementName;
Void Exclude( Rect rect )Esclude il rettangolo rect dall’area di ricerca. Esempio: Istruisci il programma a escludere il rettangolo dell’elemento ElementName. Se ElementName non viene trovato, la chiamata a questa funzione escluderà l’area di ricerca di ElementName dall’area di ricerca dell’elemento corrente. Exclude: ElementName.Rect;
Void Exclude( RectArray rectArray )Esclude dall’area di ricerca l’array di rettangoli rectArray. Esempio: Istruisci il programma a escludere i rettangoli degli elementi ElementName1, ElementName2 ed ElementName3. Se uno di questi elementi non viene rilevato, alla chiamata di questa funzione le rispettive aree di ricerca verranno escluse dall’area di ricerca dell’elemento corrente. Exclude: RectArray(ElementName1.Rect or ElementName2.Rect or ElementName3.Rect);
Void ExcludeRect( XInterval left, YInterval top, XInterval right, YInterval bottom )Esclude dall’area di ricerca il FuzzyRect descritto dagli intervalli left, top, right e bottom. Esempio: Istruisci il programma a escludere dall’area di ricerca un rettangolo di dimensioni assolute left = 10 dot, top = 200 dot, right = 100 dot, bottom = 400 dot. ExcludeRect: 10dt, 200dt, 100dt, 400dt;
Void ExcludeSet( ImageObjectSet set )Esclude dall’area di ricerca l’array di rettangoli dell’insieme di oggetti set. Esempio: Istruisci il programma a escludere l’array di oggetti dell’elemento ElementName dall’area di ricerca dell’elemento corrente. ExcludeSet: ElementName.Set;
Void Exclude( HypothesisInstances )Esclude dall’area di ricerca la regione delle istanze dell’ipotesi.
Void RestrictSearchArea( FuzzyRect fuzzyRect )Limita l’area di ricerca al FuzzyRect fuzzyRect. Vengono usate le coordinate globali.
Void RestrictSearchArea( FuzzyRect, IntArray pages )Limita l’area di ricerca con il FuzzyRect fuzzyRect. Specificare le coordinate locali e l’intervallo di Pagine pages.
Void RestrictSearchArea( FuzzyRect, SearchAreaPageSetType )Limita l’area di ricerca con il FuzzyRect fuzzyRect. Specificare le coordinate locali e l’intervallo di Pagine del tipo SearchAreaPageSetType.
Void RestrictSearchArea( RectArray rectArray )Limita l’area di ricerca all’array di rettangoli rectArray. Vengono usate le coordinate globali. Esempio: È possibile specificare che i confini dell’area di ricerca dell’elemento corrente siano definiti dai confini dei rettangoli degli elementi ElementName1, ElementName2 ed ElementName3. Se uno degli elementi non viene rilevato, alla chiamata di questa funzione l’area di ricerca dell’elemento corrente sarà definita dai confini delle aree di ricerca degli elementi corrispondenti. RestrictSearchArea: RectArray(ElementName1.Rect or ElementName2.Rect or ElementName3.Rect);
Void RestrictSearchArea( RectArray, IntArray pages )Limita l’area di ricerca con l’array di rettangoli rectArray. Specificare le coordinate locali e l’intervallo di Pagine pages.
Void RestrictSearchArea( RectArray, SearchAreaPageSetType )Limita l’area di ricerca con l’array di rettangoli rectArray. Specificare le coordinate locali e l’intervallo di Pagine del tipo SearchAreaPageSetType.
Void RestrictSearchArea( Region region )Limita l’area di ricerca alla regione region. Vengono usate le coordinate globali. Esempio: È possibile specificare che l’area di ricerca dell’elemento corrente sia delimitata dalla regione dell’elemento ElementName. RestrictSearchArea: ElementName.Region;
Void RestrictSearchArea( Region, IntArray pages )Limita l’area di ricerca con la regione. Specificare le coordinate locali e l’intervallo di Pagine pages.
Void RestrictSearchArea( Region, SearchAreaPageSetType )Limita l’area di ricerca in base alla regione. Specificare le coordinate locali e l’intervallo di pagine del tipo SearchAreaPageSetType. Esempio: È possibile specificare che l’elemento deve essere cercato nell’area di ricerca sulle pagine pari. RestrictSearchArea: searchArea, EvenPages;
Void RestrictSearchArea( SearchAreaPageRestriction pageRestriction, IntArray pages )Limita l’intervallo di pagine in cui eseguire la ricerca senza limitare l’area di ricerca sulle pagine stesse. Il parametro pageRestriction accetta un solo valore: WholePage. Esempio: È possibile specificare che l’elemento deve essere cercato nelle pagine 2, 4, 7-9. RestrictSearchArea: WholePage, 2 << 4 << 7 << 8 << 9;
Void RestrictSearchArea( SearchAreaPageRestriction pageRestriction, SearchAreaPageSetType )Limita l’intervallo di pagine in cui eseguire la ricerca senza limitare l’area di ricerca sulle pagine stesse. Il parametro pageRestriction accetta un solo valore: WholePage. Esempio: È possibile specificare che l’elemento deve essere cercato nell’ultima pagina. RestrictSearchArea: WholePage, LastPage;
Nota: È possibile usare l’alias RSA invece del nome completo RestrictSearchArea.
Nota: I vincoli relativi alla stessa Pagina vengono applicati congiuntamente, mentre quelli per Pagine diverse vengono applicati indipendentemente. (La ricerca viene eseguita sulle Pagine per le quali è stato specificato almeno un vincolo.)

Funzioni ausiliarie che definiscono l’area di ricerca

FunctionDescription
Rect PageRect()Il rettangolo della pagina corrente in coordinate globali, usato per specificare un’area di ricerca dipendente dalla pagina. PageRect può essere usato solo per definire un’area di ricerca. Esempio: per indicare che l’elemento si trova nella metà inferiore di una pagina (senza conoscere in anticipo la pagina esatta), scrivere: Below: PageRect.Top + PageRect.Height / 2; Negli altri casi, usare la costruzione Page( N ).Rect per ottenere il rettangolo della pagina numero N, oppure DocumentRect per ottenere il rettangolo dell’intero documento. È anche possibile usare la funzione PageNumber per specificare un’area di ricerca dipendente dalla pagina.
Int PageNumber()Il numero della pagina corrente. Consente di definire un’area di ricerca dipendente dalla pagina. Esempio: supponiamo di avere un elemento ricorrente SearchElements.PageHeader. Per cercare in ogni pagina al di sotto delle istanze di questo elemento, scrivere: Below: SearchElements.PageHeader.AllInstances.PageAreaGlobal( PageNumber ).FuzzyRect, 0 * dot;