Click or drag to resize

IMcBasicFeaturesFeatureFrameIndices Property

Per-feature frame index.

Namespace:  MediaCy.IQL.Features
Assembly:  MediaCy.IQL.Features (in MediaCy.IQL.Features.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Property FeatureFrameIndices ( 
	<OptionalAttribute> Selector As Object
) As Object
	Get
	Set

Parameters

Selector (Optional)
Type: SystemObject
An empty variant, a single negative value, a single index value, or an array of zero or more index values (negative index values are legal but will be ignored). On access if the Selector argument is a negative scalar value, then a "long" array of the indices of all features for which the FrameIndex is either -1 or -(argument value + 1) is returned. That is, supplying a negative scalar index is a way of getting the list of frames that apply to a given feature. If the Selector argument is a non-negative scalar value, then the Feature FrameIndex of the indicated feature from the collection is exposed or set as a scalar long value. If the Selector argument is missing (or any negative scalar value when assigning), then the Selected property is exposed or set as an array of Longs, one for each feature. The number of elements in the array will be equal to the Count property. If Selector is an array, then zero or positive values are treated as indices into the features collection, negative values are legal but ignored. In this case, the FeatureFrameIndices will be exposed or set as an array of Long values equal to the length of the number of non-negative elements in the Selector array. Index values greater or equal to the Count property are illegal. Some Owners may provide more selection options. For McFeatures Owners for example, if the argument is a McFeatures (i.e., McPoints, McLines or McRegions) or a McBitMask, then features that intersersect the selector's bit mask are selected as if an array of index values were supplied. If the McFeatures.OptionFlags mcofFullCoverageIntersectionTest bit is set, then the test is more stringent and a feature must be fully covered by the selector's bit mask in order to be included in the selection.

Property Value

Type: Object
Remarks
The frame index value associated with each feature may be a non-negative frame index value, in which case it implies that the indicated feature is valid for only that frame. If it is a value of -1, it indicates that the feature is equally valid for all frames. The property is exposed as a Variant holding Longs. Depending on the Selector argument, the returned Variant may be a scalar Long, or it may be an array of Longs. The property is exposed as an array if the Selector argument is an array or if it is a negative scalar. On assignment, you may assign either a scalar Long or an array of Longs. The Selector argument determines which features are set with the assigned Longs. Each element in the assigning array is used and then reused as necessary to set all of the selected features; thus, when the assigning value is a scalar, all selected features are assigned the same Long value.
See Also