Function
Adds a Field to an Object.
Syntax
#include <dx/dx.h>
Object DXSetPart(Object o, int n, Field field)
Functional Details
Performs a depth-first traversal of the Object c, and replaces the nth occurrence of a subObject with class CLASS_FIELD with the Field field given. If the root of the Object given is not one of CLASS_GROUP, CLASS_XFORM, CLASS_CLIP, or CLASS_SCREEN, this function has no effect.
For applying a function to every Field in a Group, DXProcessParts is a more efficient interface.
The parts of a Group may be indexed by calling DXSetPart with successive values of n, starting at 0 until NULL is returned, provided the replacement part contains the same number of subObjects of CLASS_FIELD. This is because the replacement part will be traversed (and counted) in subsequent calls to DXSetPart.
Return Value
Returns o or returns NULL and sets an error code.
See Also
DXGetPart, DXGetPartClass, DXProcessParts
[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]