Returns a vector containing the predecessors of the specified element starting from the immediate one (which is provided
by element.predecessor
property) until the predecessor whose unique identifier
is equal to the specified one (if parameter included
is true
, that predecessor
will also be included in result vector).
GOMElement.predecessors
and GOMElement.id
properties and the functions: iterate(), Vector()
.
Parameters:
element
If not specified, the generator context element is assumed, which is the same as the call:
getPredecessorsUntilId (
contextElement, elementId, included
)
See Also: GOMContext.contextElement
Note: When this parameter is null
,
the function returns an empty vector.
elementId
See Also: GOMElement.id
When neither of the predecessors has an identifiers equal to the specified one,
the result vector will include all predecessors (same as it would
be returned by: element.predecessors.toVector()
).
included
true
, the predecessor on whom
the search was terminated will also be included in the result
vector (as its last element).
GOMElement.id, findElementById()