SE_shape_insert_part

Inserts a new part into a shape.

Usage syntax

LONG SE_shape_insert_part (const SE_SHAPE src_shape, LONG part_num, SE_SHAPE tgt_shape);

Parameters
src_shape A handle to an active shape object containing the new part
part_num The position in the target shape to insert the new parts
tgt_shape A handle to an active shape object
Description

Inserts a new part into a supplied target shape. The new part is supplied as a shape, and is inserted into the position defined by part_num in the target shape. Any existing parts in the target shape are shifted up to accommodate the newly inserted part. If the target shape contains one or more parts and the source and target shapes are not of the same type, the operation fails. If the source shape has multiple parts, all parts of the source shape are added in the same order to the target shape.

Returns

SE_SUCCESS
SE_CAD_EXISTS

SE_INCOMPATIBLE_COORDREFS

SE_INCOMPATIBLE_SHAPES

SE_INVALID_PARTNUM

SE_INVALID_SHAPE

SE_INVALID_SHAPE_OBJECT

SE_OUT_OF_CLMEM

SE_READ_ONLY_SHAPE

Notes

•  If you pass a shape returned from SE_stable_search or SE_stable_get_shape to ‘tgt_shape’, the SE_READ_ONLY_SHAPE error is returned.

•  If the source shape has a CAD entity, the SE_CAD_EXISTS error is returned.