MKI_EditCopyBehind (Entity Editing) Changed in Version 2019.0

C++ Syntax

MKI_ENTITY_PTR

MKI_EditCopyBehind(

 MKI_ENTITY_PTR f_pEntity,

 MKI_ENTITY_PTR f_pRefEntity );

Copies the given entity to the drawing's object list behind the given reference entity (or to the end of the list) while maintaining its undo structure, i.e. it can be deleted by the user.

When copying an entity to the beginning of the list, it will be drawn first, i.e. it will be overdrawn by any following entity. Copying an entity to the end of the list will make it the topmost entity.

This procedure can be called inside a MKI_UndoInitProcess and MKI_UndoFinishProcess bracket.

Parameters

Entity

[MKI_ENTITY_PTR] Address of the entity to be copied in the list. This entity may reside in the current drawing, in a library, or in a reference.

RefEntity

[MKI_ENTITY_PTR] Address of a reference entity behind which the entity is to be copied. If RefEntity is nullptr, the entity will be copied to the end of the list.

Return Value

New address of the copied entity. Due to the undo structure, the address of the entity will always change!