#!F-adobe-helvetica-medium-r-normal--18* #!N #!N #!Rdxnf DXNewField #!N #!N Function #!N #!N Creates a new Field Object. #!N #!N Syntax #!N #!F-adobe-times-bold-r-normal--18* #include <dx/dx.h> Field DXNewField() #!EF #!N #!N Functional Details #!N #!N The Field Object is the fundamental Object in Data Explorer. It consists of zero or more named components, usually Arrays, that are accessed with #!F-adobe-times-bold-r-normal--18* DXGetComponentValue #!EF or #!F-adobe-times-bold-r-normal--18* DXGetEnumeratedComponentValue #!EF . Initially, the Field has no components and is said to be empty; #!F-adobe-times-bold-r-normal--18* DXEmptyField #!EF returns "1" for such Fields. Components are inserted in the Field using the function #!F-adobe-times-bold-r-normal--18* DXSetComponentValue #!EF . #!N #!N There are several predefined component names in Data Explorer. The component "positions" generally refers to the points in the data space where the field is sampled; "connections" are the relationships between the "positions" and their interpolation; "data" refers to the values either at the "positions" or for each whole "connections" element. #!N #!N The Field created can be deleted with DXDelete. See #!Lmemng,dxall1023 h Memory Management #!EL . #!N #!N Note that certain attributes on the components on a field are necessary for proper processing of the field. For example, a "connections" component must "ref" the "positions" component, and the "data" component must "dep" either the "positions" or "connections" component (see #!Lcompatt3,dxall223 t Table 3 #!EL in IBM Visualization Data Explorer User's Guide, and #!Ldatam,dxall1022 h Data Explorer Data Model #!EL ). #!N #!N It is recommended that DXEndField be called on any field created when you are finished adding components to it. DXEndField trims away allocated but unused space in the component arrays, and will in addition, set some default component attributes. See #!Ldxendf,dxall1201 h DXEndField #!EL for more information. #!N #!N See #!Ldatmod,dxall197 h Understanding the Data Model #!EL in IBM Visualization Data Explorer User's Guide for additional information on the Data Explorer data model. #!N #!N Return Value #!N #!N Returns the Field or returns #!F-adobe-times-bold-r-normal--18* NULL #!EF and sets an error code. #!N #!N See Also #!N #!N #!F-adobe-times-bold-r-normal--18* #!Ldxemf,dxall1200 h DXEmptyField #!EL , #!Ldxgcv,dxall1228 h DXGetComponentValue #!EL , #!Ldxgecv,dxall1233 h DXGetEnumeratedComponentValue #!EL , #!Ldxscv,dxall1372 h DXSetComponentValue #!EL #!EF #!N #!N #!Lfieldsc,dxall1062 h Field Class #!EL . #!N #!N #!N #!F-adobe-times-medium-i-normal--18* Next Topic #!EF #!N #!N #!Ldxng,dxall1317 h DXNewGroup #!EL #!N #!F-adobe-times-medium-i-normal--18* #!N
Generated by dwww version 1.15 on Sat Jun 22 12:59:21 CEST 2024.