pyplot.import_sheet

Imports one or more sheets from a plot template file.

pyplot.import_sheet(file, [name])

Parameter	Type	Description
file	path handle	The plot template file that should be imported
name	string (optional)	If specified, all imported sheets are renamed to this name

Return value

Type	Description
{ element_handle* }	A table containing the imported sheet handles

Example:

local sheets = pyplot.import_sheet(template_file, "Imported Sheet")

Remarks:

The function imports all sheets contained in the given template file.

If the current album already contains sheets, the printer settings of the imported template are not copied. If the album is empty, the printer settings are copied as well.

If a non-empty name is given, every imported sheet is renamed to that name.

The return value is a Lua table containing the imported sheet handles in import order.

Version Support:

Minimum PYTHA Version: V26

See also:

pyplot.create_sheet, pyplot.delete_sheet