IBM Visualization Data Explorer Programmer's Reference

DXCreateInvalidComponentHandle

Function

Creates an invalid-component handle.

Syntax

#include <dx/dx.h>

InvalidComponentHandle DXCreateInvalidComponentHandle(Object object,
Array array, char *name)

Functional Details

The invalid-component handle is necessary in order to use the other invalid-component routines.

object	specifies: a Field for which an invalid-component Array is to be created; or one of the following kinds of array: "positions," "connections," "face," or "polylines."
array	allows an initial "invalid positions" or "invalid connections" component to be passed in to initialize the handle. Note: If object is a Field, it is not necessary to specify array, since the initial invalid component will be found in the Field. However, if object is a Field and array is not NULL, then array supersedes the invalid Array in the Field.
name	Specifies the component referred to by the invalid component: "positions," "connections.," "faces," or "polylines."

When you have finished using it, delete the invalid-component handle with DXFreeInvalidComponentHandle.

Return Value

Returns the invalid-component handle or returns NULL and sets an error code.

See Also

DXFreeInvalidComponentHandle, DXGetInvalidCount, DXGetValidCount, DXInvertValidity, DXIsElementValid, DXIsElementInvalid, DXSaveInvalidComponent, DXSetAllInvalid, DXSetAllValid, DXSetElementInvalid, DXSetElementValid

14.3 , "Invalid Data".

[Data Explorer Home Page]