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

See also paste.

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.