Description

Duplicate frames from this collection into a new McFrames instance

Return Type

A McFrames object.  

A new McFrames instance holding the specified FramesToDuplicate.

Syntax

object.Duplicate ([FramesToDuplicate])

The Duplicate Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McFrames.
FramesToDuplicateOptional. A Variant value.

VARIANT : An optional selector for the frames to be duplicated from the collection. If missing or a scalar -1, all frames in the collection are duplicated. This selector may be an array of VARIANT, in which case the contents of each VARIANT are duplicated from the collection. Each VARIANT may be a single scalar index value (if negative, then all frames inthe source collection are duplicated), or it may be a single scalar LONGRANGE giving Start and End source collection indices, or it may be an array of collection index values or an array of LONGRANGE collection index ranges. In addition, it may be an McFrame object instance or an array of them to be added to the duplicated collection. Finally, the FramesSelector argument may be an McFrames collection (or an array of them) with a ParentImage the same as this one's. In this case frames from the source McFrames collection(s) are added to the duplicated McFrames collection.

Remarks

The McFrame instances to be duplicated in the new collection can be specified in a number of ways based on the optional FramesToDuplicate argument. If the FramesToDuplicate argument is missing, then all frames in the source collectionare duplicated in the new collection.

Exceptions

Frames added must have the same ParentImage as this one's. Frame indices specified must be within the range from 0 to Count-1.

Notes

Indices specified in the FramesToDuplicate argument are source McFrames collection indices, not FrameIndex values for the position of the frame in its ParentImage.