API reference / Common / Engine types / ShapeFragment

Interface: ShapeFragment

A set of shape-tree nodes lifted from one tree, in the order they were selected — the copy of a Shapes selection. Each carries its full content subtree (a group brings its children).

The shapes keep their source ids; minting fresh ids for a re-inserted subtree (a same-document paste can't reuse a source id) is the paster's job, not the fragment's. The resource parts those shapes reference (pictures, …) are carried as-is, so a same-document paste shares them.

Serialize/Deserialize make it the wire form a host can stash on the system clipboard and hand back verbatim to a paste.

Properties

Property	Description
nodes ShapeNode[]	The lifted nodes, each with its whole subtree.