js editor
Web development
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.
-
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.
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.
| В |  Copy Code |
|---|---|
loForm1 = CREATEOBJECT("myForm1")
loForm2 = CREATEOBJECT("myForm2")
loCol = CREATEOBJECT("myCollection")
loCol.Add(loForm1)
loCol.Add(loForm2)
? loCol.Count
loCol.Remove(1)
? loCol.Count | |