Converts the specified enumeration of source elements (i.e. GOMElement
objects) into another enumeration of elements,
in which some of the source elements may be passed unchanged or replaced with new elements produced from the corresponding source ones.
The ordering of elements in the result enumeration will correspond to the original one.
Parameters:
sourceElements
elementsQuery
The subquery should be prepared using FlexQuery()
function.
It will be executed against each source element, which is passed to the subquery
as the generator context element (see GOMContext.contextElement
).
The subquery should return either a single element (i.e. GOMElement
object) or
an enumeration of elements, all of which will be added to the result enumeration.
Any other value returned by the subquery will be ignored.
When either sourceElements
or elementsQuery
parameter is null
,
an empty enumeration is returned.