Create Function

Creates a new composite item from given object items in an Envision document currently opened in the Canvas Envision Creator app.

    Create(subObjs: [[[EvItem|canvas-envision-document-items.html#object-items]]][], zOrder?: [[[EvObjectZOrder|evobjectzorder-interface.html]]]): Promise<[[[EvItem|canvas-envision-document-items.html#object-items]]]>

Parameters

subObjs: EvItem[]

An array of Object item objects, object items from the Envision document currently opened in the Canvas Envision Creator app that should constitute a new composite item.

zOrder?: EvObjectZOrder

An EvObjectZOrder object that includes:

The layer item object of a layer in the current document where the new composite item should be added. The default value is the current layer on the current page.
The position of the new composite item in the stack of object items on the given layer. It is a zero-based index that is 0 for the topmost object item on the layer and increases by 1 for each following object item going down the stack. The default value is 0.

Return value

Promise<EvItem>: A Promise that, if fulfilled, resolves to an Object item object of the new composite item successfully created from the given object items in the current document.

18 April 2025