C++ Syntax

MKI_ExtDataOpen(

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

Only one provisional extended object is available at a time. Anyway, other provisional entities like object, instance, block and group can be open simultaneously. After opening the provisional extended object, it must later be closed using MKI_ExtDataClose, thus making the new, provisional data list active. The old extended data list will be deleted. Please note that the object's data blocks or its display 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

f_pExt

[MKI_ENTITY_EXT_PTR] Address of the extended object whose data 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 provisional extended object is already open.