MKI_ExtInsert (Entity Creation) Changed in Version 2019.0

C++ Syntax

MKI_ENTITY_EXT_PTR

MKI_ExtInsert(

 MKI_CONST_ENTITY_PTR f_pRefEntity );

Inserts the temporary extended object (see MKI_ExtOpen) to a memory list. If no temporary clipping surface, group, or block is currently open, the extended object is inserted to the main memory list of the drawing behind the object pointed to by RefEntity. If RefEntity is nullptr, the extended object is appended at the end.

If a temporary clipping surface, group, or block is currently open (in that order), the extended object is appended to that entity. RefEntity is ignored in this case.

In most cases, you can use MKI_ExtFastInsert instead of this procedure to speed up execution and to reduce code size. See the description of that procedure for details.

Parameters

RefEntity

[MKI_CONST_ENTITY_PTR] Address of a reference entity behind which the extended object shall be inserted. If RefEntity is nullptr, the extended object is appended at the end.

Return Value

Returns the address of the inserted extended object. Returns nullptr if the insertion was not successful, normally due to insufficient memory.