IMcRegions2SetRotatableBox Method
|
|
A rotatable rectangular feature is created.
Namespace:
MediaCy.IQL.Features
Assembly:
MediaCy.IQL.Features (in MediaCy.IQL.Features.dll) Version: 10.0.6912.0
SyntaxSub SetRotatableBox (
lIndex As Integer,
Bounds As Object,
Optional Angle As Double = 0
)
Parameters
- lIndex
- Type: SystemInt32
Index of subregion to make into an rotatable box. If -1,
all existing regions are removed and a single rotatable rectangular region is
created at index 0. - Bounds
- Type: SystemObject
The bounds of the unrotated rectangle. This may be given as a
length-4 numerical array in the order left,top,right,bottom or a RECT structure
(SINGLERECT is the natural coordinate storage). - Angle (Optional)
- Type: SystemDouble
Rotation of the given Bounds about its center point, in degrees
counterclockwise from the horizontal. This angle is constrained
to the range of zero to 360.
RemarksThe FeatureType will have the mcftRectangleAny bit set in its Type. The
actual Type be mcftBox, mcftFreeBox, mcftSquare or mcftFreeSquare. The Type is determined
from the assigned parameters and the state of the mcofDefaultFreeBox
and mcofDefaultSquare bits of the OptionFlags. If both of these bits are clear
(this is the default state), then any SetRotatableBox call made with the Angle
argument zero will be of Type mcftBox. The McGraphObjRect linked to
features of Type mcftBox cannot be rotated by the user (i.e., the
mcgsAllowRotate bit of their Style property is cleared).
A SetRotatableBox call with Angle non-zero or with the mcofDefaultFreeBox bit
of OptionFlags set, will create a feature of Type mcftFreeBox. The
McGraphObjRect linked to features of Type mcftFreeBox can be rotated by
the user (i.e., the mcgsAllowRotate bit of their Style property is set).
If the mcofDefaultSquare bit of the OptionFlags property is set, then a
SetEllipse call with MajAx equal to MinAx will create a feature of Type
mcftSquare. Features of this type are linked to McGraphObjRect instances with the
Square property set True.
See Also