Add Picture Shape

For a more informative report, you may add pictures as shapes to the TemplateSheet. The positions of the pictures in the report can vary based on the expanding cell.

Note that in ReportSheets, a picture does not support grouping but follows a certain positioning strategy. A picture is positioned by its start row and start column and is affected by the value of the template cell's pin property, consistent with the scaling strategy for 'static' cells. Its size remains constant and identical to the image in the TemplateSheet.

Here are some examples of picture positioning shown below.

Example 1: If the picture's top or left edge is on the same row or column as the expanding cell, then the picture will be positioned according to the first cell expanded by the current expanding cell.

Example 2: If an expanding cell appears in front of or to the left of the picture, then the expanding cell will push the picture back.

To add a picture shape, you need to use the addPictureShape method and specify the parameters such as name, source, location (x and y), and size (width and height).

The following code sample shows how to add a picture shape to the TemplateSheet.

// Add picture shape to the TemplateSheet.
let picture = templateSheet.shapes.addPictureShape("picture", '/imageSrc.png', 0, 0, 200, 200); 

// Adjust the picture shape.
picture.startRow(0);
picture.endRow(6)
picture.startColumn(6);
picture.endColumn(6);
picture.startColumnOffset(60);