MKI_EditMoveBefore (Entity Editing) Changed in Version 2019.0

C++ Syntax

bool

MKI_EditMoveBefore(

 MKI_ENTITY_PTR f_pEntity,

 MKI_ENTITY_PTR f_pRefEntity );

Moves the given entity inside the drawing's object list before the given reference object (or to the end of the list). This cannot be undone.

Make sure that the entity you want to move and the reference entity (if any) are already part of the drawing's object list! If not, the internal lists may get corrupted and the system might reveal unexpected behavior.

bool

MKI_EditMoveBefore(

 MKI_ENTITY_PTR f_pParent,

 MKI_ENTITY_PTR f_pEntity,

 MKI_ENTITY_PTR f_pRefEntity );

Moves the given entity inside the given parent's link list before the given reference object (or to the end of the list). This cannot be undone.

Make sure that the entity you want to move and the reference entity (if any) are already part of the parent's link list! If not, the internal lists may get corrupted and the system might reveal unexpected behavior.

Parameters

Parent

[MKI_ENTITY_PTR] Address of the parent entity (e.g. block or group) in whose link list the entity shall be moved.

Entity

[MKI_ENTITY_PTR] Address of the entity to be moved in the list.

RefEntity

[MKI_ENTITY_PTR] Address of a reference entity before which the entity is to be moved. If RefEntity is nullptr, the entity will be moved to the beginning of the list.

Return Value

Returns true if successful. If false is returned, this is usually due to incorrect parameters.

Moving an entity within the entity list will change the drawing order of the entity. When moving an entity to the beginning of the list, it will be drawn first, i.e. it will be overdrawn by any following entity. Moving an entity to the end of the list will make it the topmost entity.