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 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.

Returns:

The enumeration of 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.

See Also:

findElementById(), getElementIds(), GOMElement.id

${include ../../../refs/element_id.htm}

${include ../../../refs/matching_ets_spec.htm}

${include ../../../refs/element_types.htm}