paste_element

Description:

public TimelineElement? paste_element (TimelineElement element, ClockTime position, int layer_priority)

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).

Parameters:

this	The Timeline onto which `element` should be pasted
element	The element to paste
position	The position in the timeline `element` should be pasted to, i.e. the start value for the pasted element.
layer_priority	The layer into which the element should be pasted. -1 means paste to the same layer from which `element` has been copied from

Returns:

The newly created element, or null if pasting fails.