Click or drag to resize

IMcRegions2SourceFlags Property

Per feature source flags

Namespace:  MediaCy.IQL.Features
Assembly:  MediaCy.IQL.Features (in MediaCy.IQL.Features.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Property SourceFlags ( 
	<OptionalAttribute> Selector As Object,
	Optional Mask As Integer = -1
) 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). If the Selector argument is a non-negative scalar value, then SourceFlags of the indicated feature from the collection is exposed or set as a scalar Long value. If the Selector argument is a value of negative one (-1), then SourceFlags of all features from the collection are exposed or set as a scalar Long value. The property will be the OR'ed SourceFlags flags of all features in the collection. If the Selector argument is missing or any negative value other than minus 1, then the Selected property is exposed or set as an array of Long 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, the SourceFlags 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. 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.
Mask (Optional)
Type: SystemInt32
A mask for the flags being set or accessed. Default value is -1 (all bits are exposed or set).

Property Value

Type: Object

Implements

IMcRegionsSourceFlagsObject, Int32
Remarks
The SourceFlags property is used by some measurements that expose a McFeatures to indicate the source of each computed feature. If the stored flags are of no interest to the user, this property may be used for storage of a single Long value. The property is exposed as a Long VARIANT. Depending on the Selector argument, the returned VARIANT may be a scalar 'Long' value, or it may be an array of such values. The property is exposed as an array if the Selector argument is an array or if it is a negative scalar value other than -1.
Examples
VB
Copy
With ThisApplication.ActiveImage.PointFeatures
'Create three points
.SetFeaturePoints -1, Array(10, 10, 20, 20, 30, 30)
'Set SourceFlags for all three
.SourceFlags = Array(1, 2, 3)
Debug.Print "SourceFlags = " & McToText(.SourceFlags)
'Set the second one to an odd value
.SourceFlags(1) = 5
Debug.Print "SourceFlags = " & McToText(.SourceFlags)
'Make them all even values assigning with a Mask of 1
.SourceFlags(-1, 1) = 0
Debug.Print "SourceFlags = " & McToText(.SourceFlags)
'Show only the first and third flags
Debug.Print "1st and 3rd SourceFlags = " & McToText(.SourceFlags(Array(0, 2)))
'Show all flags Or'ed together
Debug.Print "All SourceFlags Or'ed together = " & McToText(.SourceFlags(-1))
End With
See Also