Finds elements by the specified unique identifiers and returns the enumeration of the found elements.
(See What is Element Unique Identifier?)
Effectively, this function does the same as the following Java code would do:
Vector v = new Vector();
for (int i = 0; i < elementIds.length; i ++)
{
GOMElement element =
findElementById(elementIds[i], elementTypeSpec);
if (element != null)
v.add(element);
}
return v.elements();
elementIds
elementTypeSpec
When this parameter is specified, only those initially found elements will be included in the result enumeration, which comply with at least one of the specified target Element Types.
Note: You may need to specify this parameter even when any elements
to find are guaranteed to comply with a certain known Element Type.
In that case, the returned GOMElement
instances will
be resolved with that Element Type, which may be needed for further processing.
(For details, see What are Element Types?)
filterQuery
This should be a boolean subquery created with BooleanQuery()
function.
The subquery will be processed against each initially selected element.
It must return true
if the element should be included in the result enumeration
and false
otherwise.
The tested element is passed as the generator context element.
GOMElement
instances representing the found elements.
When elementTypeSpec
parameter is specified,
the element instances will be resolved with one of the matching target Element Types.
findElementById(), getElementIds(), GOMElement.id
${include ../../../refs/element_id.htm}
${include ../../../refs/matching_ets_spec.htm}
${include ../../../refs/element_types.htm}