| SE_shape_extend_line | |
Extends a linear shape by adding a specified string of points to the beginning or end of the shape.
LONG SE_shape_extend_line (SE_SHAPE shape, SE_SDEPOINT *endpoint, SE_SDEPOINT *pointlist, LONG num_pts);
| shape | A handle to an active SE_SHAPE object that is any type of valid linear shape |
| endpoint | Address of an SE_SDEPOINT structure that holds the coordinate location of the endpoint to extend from. Must be equal to the first or last point in a component of the shape. |
| pointlist | Address of the list of new coordinate points |
| num_pts | Number of points in the pointlist list |
SE_shape_extend_line adds a set of new points to the beginning or end of the shape’s point array. If endpoint does not equal either the first or last point in the string, then SE_INVALID_END_PT is returned and the shape is left unchanged.
The z- and m-values of the SE_SDEPOINT structures are ignored unless the input shape has a z-coordinate array and/or a measures array.
SE_SUCCESS
SE_CAD_EXISTS
SE_COORD_OUT_OF_BOUNDS
SE_FAILURE
SE_INVALID_END_PT
SE_INVALID_ENTITY_TYPE
SE_INVALID_POINTER
SE_INVALID_SHAPE_OBJECT
SE_OUT_OF_CLMEM
SE_PT_NO_EXIST
SE_READ_ONLY_SHAPE
SE_SHAPE_INTEGRITY_ERROR
• If this function fails, the source shape is unchanged.
• If you pass a shape returned from SE_stable_search or SE_stable_get_shape to ‘shape’, the SE_READ_ONLY_SHAPE error is returned.
• If the source shape has a CAD entity, the SE_CAD_EXISTS error is returned.
• See also SE_shape_change_path.