Command: setPrintArea

This is an equivalent of the setPrintAreas method from IFrame API, but only for one surface (either a specified or the current surface).

Unlike changeLayout command, the design is loaded completely, including the background.

Params

  • data - the same print area definition as used in the setPrintAreas.
  • surfaceIndex - which surface is to replace. If omitted, the currently visible surface is modified.
  • options - history management options. See the setPrintAreas docs for more details.

Example

{
    "type": "canvas", 
    "name": "editor",
    "params": {
        "inital": { ... }, 
        "setPrintArea": {
            "discardChanges": false,
            "data": {
                "designFile": "{{'demos/cards/'+$['designs']._.name}}"
            }
        }
     }
}