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 provisional extended object (see MKI_ExtOpen) to a memory list. If no provisional 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 f_pRefEntity. If f_pRefEntity is nullptr, the extended object is appended at the end.

If a provisional clipping surface, group, or block is currently open (in that order), the extended object is appended to that entity. f_pRefEntity 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

f_pRefEntity

[MKI_CONST_ENTITY_PTR] Address of a reference entity behind which the extended object shall be inserted. If f_pRefEntity 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.