MKI_GroupInsert (Entity Creation) Changed in Version 2019.0

C++ Syntax

MKI_ENTITY_GROUP_PTR

MKI_GroupInsert(

 MKI_CONST_ENTITY_PTR f_pRefEntity );

Appends the provisional group (see MKI_GroupOpen) to a memory list. If no provisional block is currently open, the group is inserted to the main memory list of the drawing behind the object pointed to by f_pRefEntity. If f_pRefEntity is nullptr, the group is appended at the end.

If a provisional block is currently open, the group is appended to that entity. f_pRefEntity is ignored in this case.

Parameters

f_pRefEntity New in Version 2018.0

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

Return Value

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