| SE_shape_delete_path | |
Deletes a path from the specified shape.
LONG SE_shape_delete_path (SE_SHAPE shape, SE_SDEPOINT *firstpt, SE_SDEPOINT *midpt, SE_SDEPOINT *lastpt);
| shape | A handle to an active shape object from which to delete the path |
| firstpt | An SE_SDEPOINT structure containing the coordinates of the path’s start point |
| midpt | An SE_SDEPOINT structure containing the coordinate values of any point along the path |
| lastpt | An SE_SDEPOINT structure containing the coordinate values of the endpoint in the path |
SE_shape_delete_path removes a path (sequence of points) from the source shape, not including the firstpt and lastpt. The path is specified by a start point, endpoint, and any point along the path. The resulting shape is automatically verified to catch illegal shapes.
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_FAILURE
SE_INVALID_ENTITY_TYPE
SE_INVALID_POINTER
SE_INVALID_SHAPE_OBJECT
SE_OUT_OF_CLMEM
SE_PATH_NOT_FOUND
SE_READ_ONLY_SHAPE
SE_SHAPE_INTEGRITY_ERROR
• Only points lying between the first and last points in the path are removed.
• 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. See ‘Shape table functions’ for more information.
• If the source shape has a CAD entity, the SE_CAD_EXISTS error is returned.
• See also SE_shape_delete_point.