IBM Visualization Data Explorer Programmer's Reference

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

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".


[ 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]


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