Finds elements by the specified unique identifiers and returns the enumeration of the found elements.
(See "What is Element Unique Identifier?" below.)
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();
Parameters:
elementIds
The array with the unique identifier of the elements to find.
elementTypeSpec
The list of target Element Types (see "Specifying Matching Element Types" below).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?" below.)
filterQuery
Specify an additional condition on the returned elements.This should be a boolean subquery created with
BooleanQuery()
function. The subquery will be processed against each initially selected element. It must returntrue
if the element should be included in the result enumeration andfalse
otherwise. The tested element is passed as the generator context element.
Returns:
The enumeration ofGOMElement
instances representing the found elements.When
elementTypeSpec
parameter is specified, the element instances will be resolved with one of the matching target Element Types.
See Also:
findElementById(), getElementIds(), GOMElement.id
${include ../../../refs/element_id.htm}
${include ../../../refs/matching_ets_spec.htm}
${include ../../../refs/element_types.htm}