sheetConfig
Sheet configuration settings are the Master Page, Media and Duplex printing options of first/middle/last/single or all sheets in a Print section. The sheetConfig object holds these options and can
be used to set (or rather, override) them via a Control Script (see Control Scripts and Control Script API). This is especially useful when you need identical sections with different sheet configuration settings.
The sheetConfig object can be retrieved via the section object (see section); see the example below.
Fields
The fields of the sheetConfig object correspond to settings in the Sheet Configuration dialog; see Sheet Configuration dialog.
| Field | Type | Description |
|---|---|---|
| duplex | Boolean |
Enables or disables duplex (two-sided) printing. |
| facingPages | Boolean |
(Only with duplex printing.) When |
| mediaRotation | Number | Rotates the Media (to be more accurate: the Virtual Stationery images specified for this Media) by 0, 90, 180, or -90 degrees. |
| omitEmptyBackside | Boolean | (Only with duplex printing.) Resets a page to Simplex if it has an empty back side. This may reduce volume printing costs. |
| positions | Positions (see Position) | Used to modify the Master Page and Media and to allow content on sheets in different positions; for example: var section1 = merge.template.contexts.PRINT.sections[0];For an overview of the available settings in each position see Position. Can also be used to repeat the sheet configuration within a document. |
| tumble | Boolean | (Only with duplex printing.) When tumble is set to true, pages are printed like in a calendar. (On Portrait output,
this would be equivalent to short-edge duplex.) |
Example
This script retrieves a section and changes its sheet configuration settings.
let section = merge.template.contexts.PRINT.sections["Section 1"];
section.sheetConfig.duplex = true;
section.sheetConfig.omitEmptyBackside = true;
section.sheetConfig.facingPages = true;
section.sheetConfig.mediaRotation = 0;