C++ Syntax

MKI_ENTITY_EXT_PTR

MKI_ExtOpen(

__int16 f_nOwnerID,

__int32 f_nType,

__int32 f_nFlag,

__int32 f_nVersion );

Opens a temporary extended object for data block input. Once opened, the temporary extended object can be filled with data blocks and subsequently be terminated and appended to a memory list or to a block.

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_ExtClose or MKI_ExtFastInsert.

Parameters

OwnerID

[__int16] This value is a unique identification of the creator of the plug-in. The value MKI_DB_OWNER_MK is reserved for use by Malz++Kassner. Valid range: 0 <= Value < 10000.

Third-party vendors that plan to implement a plug-in should contact Malz++Kassner to receive their unique identification (see Getting Your Private Owner ID).

Type

[__int32] Type of extended object to be created. This type can freely be defined by the plug-in.

Flag New in Version 6.0

[__int32] Flag indicating the basic type of the object, i.e. how it should behave in the eye of the user (see MKI_EXTFLAG_*).

Version New in Version 6.41

[__int32] Internal version of the extended entity. If Version is zero, the application assumes that no version management is used by the plug-in. If Version is non-zero, the application will display a warning when trying to save this entity in a file with a version older than 6.40 to avoid unresolved version conflicts. The version management of the entity is totally up to the plug-in!

Return Value

Address of the temporary 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.