C++ Syntax

MKI_ExtListOpen(

Opens the display list of an extended object for adding display data to that extended object. Once opened, objects and instances can added to a new, temporary display data list. This list will not become active unless MKI_ExtListClose is called, i.e. the old display list will remain accessible until then.

Only one temporary extended object is available at a time. Anyway, other temporary entities like object, instance, block and group can be open simultaneously. After opening the temporary extended object, it must later be closed using MKI_ExtListClose, thus making the new, temporary display list active. The old display data list will be deleted. Please note that the object's data blocks or it s extended data list cannot be modified at this time! To create a modified extended object, delete the current one and create a new one using MKI_ExtOpen!

Parameters

Ext

[MKI_ENTITY_EXT_PTR] Address of the extended object whose display list shall be opened.

Return Value

Address of the extended object, if successful. This address can be used to modify the extended object's extended properties (located in ReturnValue->XProperty) and the display matrix (located in ReturnValue->DisplayMatrix). Please do not modify any other value! If nullptr is returned, this indicates that another temporary extended object is already open.