SE_shape_delete_island

Deletes an island ring from a polygon shape.

Usage syntax

LONG SE_shape_delete_island (SE_SHAPE shape, SE_POINT *pt );

Parameters
shape A handle to an active shape object
pt Address of any coordinate point on the island to delete
Description

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.

Returns

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

Notes

•  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.