Click or drag to resize

IMcFeaturesGetFeatureBoundingBox Method

Returns the bounds of all or selected features

Namespace:  MediaCy.IQL.Features
Assembly:  MediaCy.IQL.Features (in MediaCy.IQL.Features.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Sub GetFeatureBoundingBox ( 
	Selector As Object,
	<OutAttribute> ByRef left As Single,
	<OutAttribute> ByRef top As Single,
	<OutAttribute> ByRef right As Single,
	<OutAttribute> ByRef bottom As Single
)

Parameters

Selector
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 bounds of the indicated feature from the collection is returned. If the Selector argument is empty or any negative scalar value, including -1, then the bounds of the entire feature collection is returned (this is equivalent to a GetBounds call, except that the results are returned as floating point values rather than long integers). 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 smallest bound of all of the indicated features is returned (i.e., the intersection of all of their individual bounds). 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.
left
Type: SystemSingle
left side of the region
top
Type: SystemSingle
upper side of the region
right
Type: SystemSingle
right side of the region
bottom
Type: SystemSingle
bottom side of the region
Remarks
This method returns its results as four separate values. The BoundingRect property exposes the bounds of all or selected features as a SINGLERECT, which may be more convenient in many situations. If this McFeatures is IsReset (as it was after it was first created and after a Reset call) or if the mcOptionFlags.mcofInvertFeatureMask OptionFlags bit is set and all features are selected, then the bounds returned will be that of a backing McImage (this is the bounds that AccessMaskedImageData will use for an IsReset McFeatures). Otherwise, if there are no features selected (either because the Selector is an empty array or because there are no features), then left will be returned as greater than right.
See Also