Function
Adds a component to a Field.
Syntax
#include <dx/dx.h>
Field DXSetComponentValue(Field f, char *name, Object value)
Functional Details
Sets the name component of Field f to value. If name is NULL, value can be accessed only by DXGetEnumeratedComponentValue. If value is NULL, the name component will be deleted.
When DXSetComponentValue overwrites an existing component, all attributes associated with the prior value are copied to the new value and they supersede any attributes already attached to the new value. If this result is not the one desired, the earlier component value should be removed prior to setting the new one.
Components of Fields are typically Arrays and contain geometrical and topological information and associated data. These components are interrelated (e.g., an association of data with either the points defined in the "positions" component or the elements defined in the "connections" component). Their relationships are specified through attributes, which should be set as the components are inserted into the Field. After all components are inserted, call DXEndField, which will add any additional attributes (and ancillary components) that are necessary.
Return Value
Returns f or returns NULL and sets an error code.
See Also
DXDeleteComponent, DXGetComponentValue, DXGetEnumeratedComponentValue, DXNewField, DXSetComponentAttribute