Returns elements linked from the specified
IDREF
-attribute contained in the specified element.
More exactly, the function returns an enumeration of elements found
by the unique identifiers (see GOMElement.id
)
provided in the value of the specified element attribute.
The same result can be also obtained with the following expression:
findElementsByIds(
element.getAttrValues(linkAttrName)
)
In addition, the GOMElement
objects produced by this function
will have their element types automatically resolved
according to the referenced type information (i.e. the elements of which type are linked
from this attribute) provided for this attribute by the DSM Type driver.
Parameters:
element
getElementsByLinkAttr(contextElement, linkAttrName)
linkAttrName
IDREF
-attribute.
Normally, this is supposed to be a multi-valued attribute. However, a single-value attribute is also allowed. In that case, the function will simply return a single-element enumeration.
filterQuery
When specified, this should be a boolean subquery
created with BooleanQuery()
function.
The subquery will be processed against each initially selected element
and should return true
if the element must be included in the
result enumeration and false
otherwise.
The tested element is passed into the subquery as
the generator context element.
GOMElement
objects representing the found elements
or an empty enumeration otherwise
(e.g. when the attribute has an empty value list;
neither of the identifiers points to an existing element;
wrong attribute name)
getAttrValues(), findElementsByIds()