| SE_shape_set_coordref | |
Sets the coordinate system of a shape
LONG SE_shape_set_coordref (SE_SHAPE shape, SE_COORDREF coordref);
| shape | A handle to an active shape object |
| coordref | A pointer to a coordinate reference structure that defines the coordinate system |
SE_shape_set_coordref sets the coordinate reference system of a shape.
The existing geometry of the shape becomes indeterminate because is
not recreated to the new coordinate reference system.
Since the interpretation of the shape's geometry depends on the shape's
coordinate reference system, the shape's geometry must be recreated with
a shape generation function (i.e. SE_shape_generate_point) to correct
for the new coordinate reference system.
The SE_shape_change_coordref function recreates a shape's existing geometry from the previous coordinate reference system to a new coordinate reference system. Using SE_shape_change_coordref function avoids the need to manually recreate the shape's geometry since it automatically performs this task when it changes the shapes coordinate reference system.
SE_SUCCESS
SE_CAD_EXISTS
SE_INVALID_COORDREF_OBJECT
SE_INVALID_SHAPE_OBJECT
∙ If the source shape has a CAD entity, the SE_CAD_EXISTS error is returned.