2022.2

right
Numberthatrepresentsthedistance,measuredincharacters,fromtheleftedgeofthepagetotheright
edgeoftherectangularregion.
verticalOffset
Numberthatrepresentsthecurrentverticalposition,measuredinlines.
regionHeight
Numberthatrepresentsthetotalheightoftheregion,measuredinlines.
SettingtheregionHeightto0instructstheDataMappertoextractalllinesstartingfromthegivenpos-
itionuntiltheendoftherecord.
Specifyinganextractionheightthatislongerthanthenumberofremaininglinesresultsina"stepoutof
bound"errormessage.
separator
Stringinsertedbetweenalllinesreturnedfromtheregion.Ifyoudon'twantanythingtobeinserted
betweenthelines,specifyanemptystring("").
Tip:
l
"<br/>"isaveryhandystringtouseasaseparator.Whentheextracteddataisinsertedin
aDesignertemplate,"<br/>"willbeinterpretedasalinebreak,because<br/>isaline
breakinHTMLandDesignertemplatesareactuallyHTMLfiles.
l
SettingtheregionHeightto0makesitpossibletoextractavariablenumberoflinesatthe
endofarecord.
Examples
Example1:
Thescriptcommanddata.extract(1,22,8,1,"<br>");meansthattheleftpositionoftheextractedinform-
ationislocatedatcharacter1,therightpositionatcharacter22,theoffsetpositionis8(sincetheline
numberis9)andtheregionHeightis1(toselectonly1line).Finally,the"<br>"stringisusedforcon-
catenation.
Page 376