DBaddObjectKeys

Object keys to the object add.

Every object can own beside a boundless number of elements, an amount from object keys (KEY). These keys serve the classification of the objects in classes. The keys are used with the drawing of the objects, while they fix the colour and the line kinds. Also the keys can be used while selecting by objects. Because keys are figures between 1 and 65535, this is also the maximum number in the keys which an object can own. Double keys are forbidden. Also the value 0 is forbidden as a key, because he is used inside. Now with DBaddObjectKeys an amount of new keys is assigned to an object and on the observance of the rules no double and not 0 are respected as a key. The keys are hung behind the quite available ones, so that the up to now first key remains furthermore the first one.

Parametre

object (POBJECT) [IN]

The keys are added to this object.

keyCnt (int) [IN]

if the number of the keys registers in the field keys. Besides, the length of the field is indicated, not in this really available key number. It are searched in keys the indexes 0 to keyCnt-1 for valid keys.

keys (KEY *) [IN]

In this field all new keys are put down. The indexes 0 to keyCnt-1 are searched. 0-keys and double keys are removed. KEY is identical at the moment to unsigned short.

Declaration

#include "database.h"

T_ERROR DLLENTRY DBaddObjectKeys (

POBJECT object,

int keyCnt,

KEY * keys

);