The ObjAdd function adds a new empty PowerDoc object to a Power Engine document. The return value is the object's index in the Power Engine document. This index uniquely identifies the newly created PowerDoc object.
Parameter | Description |
---|---|
name |
A numerical user-defined value to be associated with the PowerDoc object. |
desc |
A valid pointer to the standard ANSI C/C++ string which holds a user-defined text description to be associated with the PowerDoc object. |
The return value is the object's index in the Power Engine document. This number uniquely identifies the newly created PowerDoc object. For this reason, we sometimes refer to this index as the object's unique serial number.
If an error occurs, the return value will be a negative number.