Frames Property

Description

A new image frames collection (McFrames).

Property type

A McFrames object.

Syntax

object.Frames([FramesSelector])

The Frames Property syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McImage.
FramesSelector	Optional. A Variant value. An optional selector for the frames to be included in the collection. If missing or a scalar -1, all frames are included. This selector may be an array of VARIANT, in which case the contents of each VARIANT are added to the collection. Each VARIANT may be a single scalar index value (if negative, then all frames are added), or it may be a single scalar LONGRANGE giving Start and End frame indices, or it may be an array of index values or an array of LONGRANGE index ranges. In addition, it may be an McFrame object instance or an array of them; each of these McFrame instances must one of the frames in this McImage's frame list (see the Frame property). Finally, the FramesSelector argument may be an McFrames collection (or an array of them) with a ParentImage the same as this one. In this case the entire contents of the McFrames collection(s) is added to the returned McFrames collection.

Remarks

McFrames gives access to a new instance of an McFrames collection of image frames. The particular frames to be included in the collection may be optionally specified. If no frames are specified, then all frames are included in the collection.

The property is exposed as a new instance of an McFrames object, holding all of the frames being managed by this image (if the FramesSelector argument is missing or a single negative number), or the frames selected by the FramesSelector argument.

Notes

If a frame is moved to another image (via MoveFrames) or is removed from the image altogether (via RemoveFrames), then that frame is automatically removed from any McFrames collection holding it.