Filter Method (McMeasures)
      
 

Description

The ancestor McFeatures features are selected based all enabled measurements

Return Type

None  

Syntax

object.Filter [AllInRangeElseAnyInRange]

The Filter Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McMeasures.
AllInRangeElseAnyInRangeOptional. A Boolean value.

If True (the default) then a feature is selected by clearing its mcfsfOutOfRange bit of the McFeatures.FeatureStatusFlags only if all of the enabled measurement values corresponding to that feature falls inside RangeMin through RangeMax. If AllInRangeElseAnyInRange is False, then then a feature is selected by clearing its mcfsfOutOfRange bit of the McFeatures.FeatureStatusFlags if any one of the enabled measurement values corresponding to that feature falls inside RangeMin through RangeMax.

Remarks

This sets the parent McFeatures.Selected and McFeatures.FeatureStatusFlags properties based on the current set of enabled measurements (ones with a True McMeasure.Enabled property).

This method will set the mcfsfOutOfRange McFeatures.FeatureStatusFlags bit and thus make Selected False) for a feature where the all enabled measurements (AllInRangeElseAnyInRange argument True) or any enabled measurement (AllInRangeElseAnyInRange argument False) for that feature is outside of the McMeasure.RangeMin to McMeasure.RangeMax property for the measurement.

The Filter method only makes sense for one-dimensional measurements (that is, ones where a single value is taken from each feature). Filterable measurements are those where Attributes(mcmaidCanFilter) is True. Measurements in the collection that do not meet this criteria are ignored for filtering purposes, even if they are Enabled.