Software Customisation
Reference Manual
Summary of Objects, Members and Methods
:
Object Type Details
: COLLECTION Object
COLLECTION Object
The collection object is used to extract database elements from the system using a selection filter (an expression object), restrictive search elements and scope lists.
Methods
Name
Result
Purpose
Collection()
Constructor (initialises all the object settings).
Scope (COLLECTION)
Empties the current scope list and makes the passed COLLECTION the current scope.
Scope (DBREF)
Empties the current scope list and makes the passed DBREF the current scope.
AddScope
Adds the passed DBREF to the current scope list.
Scope (DBREF ARRAY)
Replaces the current scope list with the passed list of DBREFs.
AppendScope (DBREF ARRAY)
Appends the passed list of DBREFs to the scope list.
ClearScope()
Empties the current scope list.
Filter (EXPRESSION)
Sets the filter to be applied to the collection.
ClearFilter ()
Empties the filter to be applied to the collection.
Type (STRING)
Empties the current scope type list and adds the passed element type.
AddType(STRING)
Adds the passed element type to the scope type list.
ClearTypes()
Empties the types to be applied to the collection.
Types (ARRAY elements)
Replaces the scope element type list with the passed list,
elements
.
AppendTypes (ARRAY types)
Appends the passed list,
types
, to the scope type list.
Initialise()
Initialises an evaluate list, so all query actions re-evaluate the collection rules. Sets index position to 1.
Filter()
EXPRESSION
Returns the expression used to filter database elements.
Scope()
DBREF ARRAY
Returns the list of database elements to scan.
Types()
STRING ARRAY
Returns the list of database element types to be collected.
Results()
DBREF ARRAY
Returns the whole collection.
Next(REAL n)
DBREF ARRAY
Returns sub array from collection of
n
elements starting at current index position.
Index()
REAL
Returns the current index of the count being used by
Next().
Size ()
REAL
Returns the number of elements in the collection.
Note:
Users can set the scope on a collection object to the whole MDB by not setting a scope or by using the ClearScope( ) method.
1974 to current year.
AVEVA Solutions Limited and its subsidiaries. All rights reserved.