IMcRegionsSetEllipse Method
|
|
An elliptical feature is created.
Namespace:
MediaCy.IQL.Features
Assembly:
MediaCy.IQL.Features (in MediaCy.IQL.Features.dll) Version: 10.0.6912.0
SyntaxSub SetEllipse (
lIndex As Integer,
Cx As Double,
Cy As Double,
MajAx As Double,
Optional MinAx As Double = 0,
Optional MajAngle As Double = 0
)
Parameters
- lIndex
- Type: SystemInt32
Index of subregion to make into an ellipse. If -1,
all existing regions are removed and a single eliptical region is
created at index 0. - Cx
- Type: SystemDouble
x-coordinate of the center of the ellipse - Cy
- Type: SystemDouble
y-coordinate of the center of the ellipse - MajAx
- Type: SystemDouble
length of the major axis (pixels) - MinAx (Optional)
- Type: SystemDouble
length of the minor axis (pixels) - MajAngle (Optional)
- Type: SystemDouble
orientation of the major axis, in degrees
counterclockwise from the horizontal. This angle is constrained
to the range of zero to 360.
RemarksThe FeatureType will have the mcftEllipseAny bit set in its Type. The
actual Type be mcftEllipse, mcftFreeEllipse, mcftCircle. The Type is determined
from the assigned ellipse parameters and the state of the mcofDefaultFreeEllipse
and mcofDefaultCircle bits of the OptionFlags. If both of these bits are clear
(this is the default state), then any SetEllipse call made with the MajAngle
argument zero will be of Type mcftEllipse. The McGraphObjEllipse linked to
features of Type mcftEllipse cannot be rotated by the user (i.e., the
mcgsAllowRotate bit of their Style property is cleared).
A SetEllipse call with MajAngle non-zero or with the mcofDefaultFreeEllipse bit
of OptionFlags set, will create a feature of Type mcftFreeEllipse. The
McGraphObjEllipse linked to features of Type mcftFreeEllipse can be rotated by
the user (i.e., the mcgsAllowRotate bit of their Style property is set).
If the mcofDefaultCircle bit of the OptionFlags property is set, then
a SetEllipse call with MajAx equal to MinAx will create a feature of Type mcftCircle.
Features of this type are linked to McGraphObjCircle linked instances..
Note that features of Type mcftCircle may have nonzero MajAngle values: in this
case, the angle specifies the angle at which any marking radial or diameter line
is to be drawn on a linked McGraphObjCircle.
See Also