Click or drag to resize

IMcRegions2Identifier Property

The feature Identifier property

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

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). If the Selector argument is a non-negative scalar value, then the Identifier of the indicated feature from the collection is returned as a scalar long value. If the Selector argument is missing or any negative value, then the property is exposed as an array of 'long' Identifier values, 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, an array of long values is returned, giving the Identifier for each positive index. 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 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. Index values greater or equal to the Count property return an Identifier of Zero.

Return Value

Type: Object
A scalar or vector of Long values each holding an Identifier value.

Implements

IMcRegionsIdentifierObject
Remarks
The feature Identifier property is a unique number associated with each feature. It is set automatically every time an feature-creation function is called (e.g. SetFeaturePoints, SetBox...). It will generally (see below for exceptions) remain unchanged for any operation that merely re-orders, removes or adds new features. It will often change for any operation that actually changes features. Identifier is a read-only property For McRegions with the mcofKeepRegionsAsUnion bit set in the OptionFlags property, the Identifier becomes invalid for almost any operation that changes the regions. The exception is simple removal of subregions; it this case, the Identifier associated with each remaining connected region is constant.
See Also