IBM Visualization Data Explorer Programmer's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

DXSetComponentValue

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

12.1 , "Field Class".


[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]


[IBM Home Page | Order | Search | Contact IBM | Legal ]