MKI_RefInsert (Entity Creation) Changed in Version 2019.0

C++ Syntax

MKI_ENTITY_REF_PTR

MKI_RefInsert(

 MKI_CONST_ENTITY_PTR f_pRefEntity );

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

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

In most cases, you can use MKI_RefFastInsert 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 drawing reference shall be inserted. If RefEntity is nullptr, the drawing reference is appended at the end.

Return Value

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