2022.2

activeSection.background.position = MediaPosition.FIT_TO_MEDIA;
Forallpossiblepositions,see"MediaPosition"onpage1296.
Setting a page range in script
WhenaPDFthatservesasadynamicsectionbackgroundhasmultiplepages,youcanspecifyarange
ofpagestobeused,inacontrolscript.
Putthenumberofthefirstpageintherangeinthesection'sbackground.startfieldandthelastpagein
background.end.
Thefollowingscriptsetsthepagerangefrom2to5:
merge.template.contexts.PRINT.sections['Policy'].background.start = 2;
merge.template.contexts.PRINT.sections['Policy'].background.end = 5;
Settingapagerangeautomaticallysetsbackground.allPagestofalse(see"background"on
page1286).
Ontheotherhand,whenyoufirstdefineapagerangeandthensetbackground.allPagestotrue,this
disablesthepagerange.
Tip: Youcouldusetheresource()functiontocheckthenumberofpagesorforexamplethe
pageheightandwidthbeforesettingitasabackground(see"resource()"onpage1278).
ThisscriptsetsabackgroundonaPrintsectionusingabsolutepositioning.
var activeSection = merge.template.contexts.PRINT.sections['Section 1'];
activeSection.background.source = BackgroundResource.RESOURCE_PDF;
activeSection.background.url = "images/somepage.pdf";
activeSection.background.position = MediaPosition.ABSOLUTE;
activeSection.background.left = "10mm";
activeSection.background.top = "10mm";
YoucouldreplacethelastthreelinesofthepreviousscriptbythefollowinglinetoscalethePrintsec-
tionbackgroundtoMediasize:
activeSection.background.position = MediaPosition.FIT_TO_MEDIA;
Dynamicallyaddingsections(cloning)
Thistopicexplainshowto"clone"(copy)asectioninaControlScript.Printsectionscanbecloned,so
thatadocumentcanhaveadynamicnumberofsections,basedondata.Thisisparticularlyuseful
whentherecordsetdefinesoneormorePDFs(e.g.insurancepolicies)perrecipient.ViaaControl
Script,foreachPDFasectioncanbeclonedandeachclonecanbegivenoneofthePDFsasback-
Page 846