Allows you to represent an array, vector, or enumeration of some arbitrary objects as an enumeration of custom elements (see "About Custom Elements" below).
This could be used to organize iterations by such objects using an Element Iterator or any other element-specific functionality.
The function creates a custom element by each object contained in the specified array/vector/enumeration so that the element's value is assigned with that object. The new elements are returned via an enumeration in the same order as the objects in the initial array/vector/enumeration.
Essentially, the function does the same as the following expression:
v = Vector(); iterate ( a, // or 'v' or 'e' @obj, FlexQuery ( v.addElement (CustomElement (obj)) ) ); v.toEnum();
Parameter:
a / v / e
The array, vector or enumeration of the objects to be wrapped into custom elements.The specified array/vector/enumeration may also include
null
objects, which will be represented as custom elements withnull
value.When this parameter itself is
null
, the function will return an empty enumeration.
Returns:
The enumeration of the custom elements produced from the initial objects.
See Also:
CustomElement(), iterate(), convertEnum()
${include ../../../refs/custom_elements.htm}