SE_shape_delete_island |
Deletes an island ring from a polygon shape.
LONG SE_shape_delete_island (SE_SHAPE shape, SE_POINT *pt );
shape | A handle to an active shape object |
pt | Address of any coordinate point on the island to delete |
SE_shape_delete_island deletes the island ring that contains the specified point from the source shape. Upon successful completion, the new shape is copied and returned in the source shape structure pointed to by shape.
SE_SUCCESS
SE_CAD_EXISTS
SE_COORD_OUT_OF_BOUNDS
SE_FAILURE
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.
• See also SE_shape_add_island .
• 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.