This function provides even more powerful way of collecting elements within
the DSM (Data Source Model) as compared to the findElementsByLPath()
function.
Now, instead of a single Location Path, the search of elements is specified using an array of Location Rules, which comprise a whole bunch of Location Paths, whose processing may be automatically repeated during a single call.
Parameters:
element
If this parameter is not specified, the generator context element
is used by default,
which is the same as the call: contextElement.findElementsByLRules(...)
See Also: GOMContext.contextElement
locationRules
Each Location Rule is represented by an object created using LocationRule()
function.
See the description of that function for more detail.
The passed array should be created with a function-call-like construct looking as
LocationRule[] (
...
)
Note: You can use the Location Rule Builder (found at the left panel's tree) to quickly construct Location Rules needed for this parameter.
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.
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.
LocationRule(), BooleanQuery(), findElementByLRules(), countElementsByLRules(),
checkElementsByLRules(), findElementsByLPath(), getValuesByLPath()