paste_element
Description:
Paste an element inside the timeline.
element
**must** be the return of copy with
`deep=TRUE`, and it should not be changed before pasting. element
itself is not placed in the timeline, instead a new element is
created, alike to the originally copied element. Note that the originally copied element must also lie within this
, at both the point of copying and pasting.
Pasting may fail if it would place the timeline in an unsupported configuration.
After calling this function element
should not be used. In particular, element
can **not** be pasted again. Instead,
you can copy the returned element and paste that copy (although, this is only possible if the paste was successful).
See also paste.
Parameters:
this |
The Timeline onto which |
element |
The element to paste |
position |
The position in the timeline |
layer_priority |
The layer into which the element should be pasted. -1 means paste to the same layer from which |
Returns:
The newly created element, or null if pasting fails. |