NAME

cxGeoPlotDataFocusSet- sets a dataset in the current plot to be the current dataset

C SPECIFICATION

#include <cx/Geometry.h>

cxErrorCode cxGeoPlotDataFocusSet (int id)

PARAMETERS

id
identifier for the dataset to be made current.

FUNCTION RETURN VALUE

cxGeoPlotDataFocusSet returns an error code, an enumerated integer with cx_err_none (zero) indicating success. Any other value indicates the absence of a prior call to cxGeoPlotBegin, or an attempt to make current a dataset which cannot be found in the current plot. A description of the error can be obtained by immediately calling cxGeoPlotGetLastError (3E).

DESCRIPTION

By default, the dataset which has been most recently added to the current plot (via cxGeoPlotDataAdd) is marked as current. This function can be used to make one of the previously added datasets to be current. It is the current dataset whose display attributes are set by calls to other cxGeoPlotData* routines; thus, this function may be used when the attributes of a previously added dataset are to be set.

SEE ALSO

cxGeoPlotDefine (3E), cxGeoPlotDataAdd (3E)

The source of the LineGraph module may be found at $EXPLORERHOME/src/LineGraph/linegraph.c (UNIX) and %EXPLORERHOME%\src\LineGraph\linegraph.c (NT). It illustrates the use of many of the cxGeoPlot* routines.


Last modified: Aug 04 14:34 1999
[
Documentation Home ]

© The Numerical Algorithms Group Ltd, Oxford UK. 1999