IMcLinesBoundingRect Property
|
|
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
SyntaxReadOnly Property BoundingRect (
<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 bounds of the indicated feature from the collection is
returned.
If the Selector argument is missing 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.
Property Value
Type:
ObjectImplements
IMcFeaturesBoundingRectObject
RemarksThis property is exposed as a SINGLERECT structure (left,top,right,bottom
Single values). This value can generally be passed directly to any argument
taking a VARIANT rectangle (e.g., the CreateFeatureMask vrectBounds argument).
By default, the property exposes the bounds of all features, but you may supply
a Selector argument to get the bounds of a selected subset of all features.
The GetFeatureBoundingBox method also provides this service, but returns its
results as 4 separate Single values.
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 (the default case), 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.
ExamplesDim rectAoiBounds As SINGLERECT
rectAoiBounds = ThisApplication.ActiveImage.Aoi.BoundingRect
Debug.Print "Aoi width is " & rectAoiBounds.right - rectAoiBounds.left
See Also