Sequence Remove Items
Removes the explicit mixed Track Item selection from a Sequence. `mediaType` selects the alignment/time grid Premiere uses for ripple removal; it does not filter the supplied items to audio or video. `shiftOverlapping` exposes Premiere's low-level removal behavior and does not by itself guarantee exact sequence-wide gap closing. Relist affected tracks after removal instead of reusing pre-removal Track Item references.
Inputs
| Input | Required | Value Kind | Types | Enum Values |
|---|---|---|---|---|
items | yes | expression | — | — |
sequence | no | expression | — | — |
ripple | no | expression | — | — |
mediaType | no | expression | — | — |
shiftOverlapping | no | expression | — | — |
onError | no | expression | enum-string | STOP, CONTINUE, RETURN_FALSE |
storeResultIn | no | variable-name | — | — |
Notes
itemsis the explicit mixed Track Item selection to remove.mediaTypedoes not filter that selection to audio or video. It selects the media alignment/time grid Premiere uses for its ripple action.shiftOverlappingexposes Premiere's low-level removal behavior; it is not a guarantee that an arbitrary sequence-wide time gap will close cleanly.- Ordinal Track Item refs select current positions, not durable identities. If an earlier Premiere Action is still queued in the same atomic execution, ordinal removal fails before either operation commits because flushing that Action would change the state before the ref is resolved. Commit the earlier transaction, determine the intended target's current ordinal, and remove it in a later transaction.
- Premiere transaction false and exceptions follow
onError(defaultSTOP).CONTINUEandRETURN_FALSEleavestoreResultIn=falsebefore the next statement; no previous true value survives a failed removal. - After removal, an old ordinal string may select a different item. Re-identify the target if later work must follow a particular clip.