Click or drag to resize

IMcFramesRemove Method

Remove frames from this collection

Namespace:  MediaCy.IQL.Engine
Assembly:  MediaCy.IQL.Engine (in MediaCy.IQL.Engine.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Sub Remove ( 
	<OptionalAttribute> FramesToRemove As Object
)

Parameters

FramesToRemove (Optional)
Type: SystemObject
An optional selector for the frames to be removed from the collection. If missing or a scalar -1, all frames in the collection are removed. This selector may be an array of Variant, in which case the contents of each Variant are removed from the collection. Each Variant may be a single scalar index value (if negative, then all frames are removed), or it may be a single scalar LONGRANGE giving Start and End 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; the first occurrance of each of these McFrame instances in the collection is removed. Finally, the FramesSelector argument may be a McFrames collection (or an array of them) with a ParentImage the same as this one's. In this case matching frames from the source McFrames collection(s) are removed from this McFrames collection.
Remarks
The McFrame instances to be removed from the collection can be specified in a number of ways based on the optional FramesToRemove argument. If the FramesToRemove argument is missing, then all frames are removed from the collection. You usually do not need to call this method, because the collection is automatically emptied when it is fully released. Frames are also automatically removed when they are moved to another image (via McImage.MoveFrames) or are removed from the image altogether (via McImage.RemoveFrames or by the McImage being fully released). Indices specified in the FramesToRemove argument are collection indices, not FrameIndex values for the position of the frame in its ParentImage. A McFrame instance may appear in a McFrames collection more than once. If it does so then you must also specify its removal more than once as well; specifying a particular McFrame instance to remove will remove only the first such instance in the collection. If a frame is moved to another image (via McImage.MoveFrames) or is removed from the image altogether (via McImage.RemoveFrames), then that frame is automatically removed from any McFrames collection holding it.
See Also