C++ Syntax

class MKI_COLLECTION_HEADER

{

public:

__int32 m_nOwnerID,

m_nType,

m_nVersion;

MKI_ITEMNAME m_szName;

MKI_COMMENTSHORT m_szComment;

void

Init( void );

};

This structure contains a collection item header.

Element Description

m_nOwnerID

[__int32] This value is a unique identification of the creator of the plug-in that created the data block. The value MKI_DB_OWNER_MK is reserved for use by Malz++Kassner, especially for collection items that are created and handled directly by the application. 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).

m_nType

[__int32] This value is an internal identification of the item. This value is known only the creator of that item. For information about this value see the documentation of the plug-in which should include a description of all collection items it uses. In combination with the owner's identification, this unambiguously identifies a certain type of collection item. Must not be negative. For a list of types used by Malz++Kassner, see MKI_COLLECTION_TYPE_*.

m_nVersion

[__int32] A mandatory version information on the collection item. Use this to ensure backward compatibility for future versions. Since collections are not automatically updated when used by a newer version, this version information is required to be able to interpret the item's contents correctly at all times. Must not be negative.

m_szName

[MKI_ITEMNAME] Name of the collection item, up to 63 characters.

m_szComment

[MKI_COMMENTSHORT] Comment on the collection item, up to 63 characters.

MKD Syntax

The section =ITEM= of a contains up to MKI_COLLECTION_ITEM_MAX item definitions. A collection header contains the description of one collection item.

Head of Section

=ITEM=

Entry for each Item Definition

Owner,Type,Version,Count,Name,Comment;

"Item Data Name 1", "Item Data Contents 1";

"Item Data Name 2", "Item Data Contents 2";

"Item Data Name 3", "Item Data Contents 3";

...

End of Section

999;

=END=

Element Description

m_nCount

[__int32] Number of item data lines to follow.