MKI_MappingInsert (Entity Creation) Changed in Version 2019.0

C++ Syntax

MKI_ENTITY_MAPPING_PTR

MKI_MappingInsert(

 MKI_CONST_ENTITY_PTR f_pRefEntity );

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

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

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

Return Value

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