paste


Description:

[ Version ( since = "1.6.0" ) ]
public TimelineElement? paste (ClockTime paste_position)

Paste an element inside the same timeline and layer as this.

this **must** be the return of copy with `deep=TRUE`, and it should not be changed before pasting. this 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 stay within the same timeline and layer, 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_element.

Parameters:

this

The TimelineElement to paste

paste_position

The position in the timeline element should be pasted to, i.e. the start value for the pasted element.

Returns:

The newly created element, or null if pasting fails.