SE_shape_add_part

Adds a new part to a given shape.

Usage syntax

LONG SE_shape_add_part (const SE_SHAPE src_shape, SE_SHAPE tgt_shape);

Parameters
src_shape A handle to an active shape object that contains the parts to add to tgt_shape
tgt_shape A handle to an active shape object to which the parts were added
Description

Adds a new part to a given shape. The new part is supplied as a shape, and is appended to the target shape. If the target shape has one or more existing 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 are added in the same order.

Returns

SE_SUCCESS
SE_CAD_EXISTS

SE_INCOMPATIBLE_COORDREFS

SE_INCOMPATIBLE_SHAPES

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