Remove Method (Collection Class)
Use to remove a member object from a collection.
The member object can have any valid type that can be assigned to a memory variable. This includes simple data types, such as strings, numbers, dates, logical, or more complex ones such as Visual FoxPro and Component Object Model (COM) objects.
Collection.Remove( eIndex )
Parameters
eIndex
Specifies an expression that represents a position of an item in the collection. This expression can be one of two types:Numeric. The eIndex expression must have a value from 1 to the value of the Count property for the collection. If you pass a value of -1, Visual FoxPro removes all items in the collection.
String. The eIndex expression must correspond to the cKey that was specified for the item when it was added to the collection.
If eIndex does not match an existing member of the collection, an error occurs.
Remarks
If an incorrect type is passed for a specific parameter, an error occurs.
Include the NODEFAULT command in the Remove method for collection objects to prevent removing a particular item from the collection.
Example
The following example illustrates these tasks at run time:
Creates forms and a collection.
Adds forms to the collection.
Displays the number of forms in the collection.
Removes the first form from the collection.
Displays the current number of forms in the collection.
loForm1 = CREATEOBJECT("myForm1")
loForm2 = CREATEOBJECT("myForm2")
loCol = CREATEOBJECT("myCollection")
loCol.Add(loForm1)
loCol.Add(loForm2)
? loCol.Count
loCol.Remove(1)
? loCol.Count
See Also
Reference
Collection Object Properties, Methods, and Events