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.

See "What are Location Rules?" section below for more information.

Parameters:

element

The initial context element against which the Location Rules are interpreted.

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
Specifies the array of Location Rules to be interpreted.

Each Location Rule is represented by an object created using LocationRule() function. See description of that function for more detail.

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

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.

See Also:

LocationRule(), BooleanQuery(), findElementByLRules(), countElementsByLRules(), checkElementsByLRules(), findElementsByLPath(), getValuesByLPath()

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

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