| RMC_SetSeriesData function. | ||
| Add the whole data to an existing series | ||
| Syntax | ||
| nResult (LONG) = RMC_SetSeriesData( ByVal nCtrlId (LONG), ByVal nRegion (LONG), ByVal nSeries (LONG), ByRef nFirstDataValue (DOUBLE), ByVal nDataValuesCount (LONG), Optional ByVal nYData (LONG) ) | ||
| Parameter | ||
| nCtrlId (LONG) | ||
| Unique ID of the chart control, to which the series belongs. | ||
| nRegion (LONG) | ||
| Index of the region, to which the series belongs. | ||
| nSeries (LONG) | ||
| Index of the series, which expects the data. | ||
| nFirstDataValue (DOUBLE) | ||
| The first element of an one-dimensional array, which holds the data. | ||
| nDataValuesCount (LONG) | ||
| The total number of elements in the data array. | ||
| nYData (DOUBLE) | ||
| Only in case of XY series: If you want to add the data for the Y-axis, pass TRUE. If this parameter is FALSE (default), the values are assigned to the X-axis. | ||
| Return value | ||
| 0 | ||
| No error, function succeeded. | ||
| RMC_ERROR_CTRLID | ||
| Wrong control ID (0 or no chart with this control ID was found). | ||
| RMC_ERROR_WRONGREGION | ||
| The region index is inexistent in the chart control. | ||
| RMC_ERROR_SERIESINDEX | ||
| The series index is not valid (No series with this index exists in this region). | ||
| RMC_ERROR_ALLOC | ||
| Error while allocating memory for the data. | ||
| Example | ||
i = RMC_AddBarSeries(%ID_RMC,1,0,0) ' Add a bar series without data values ... ... ... ' later, for example when the user clicked a button or the data arrived from anywhere: i = RMC_SetSeriesData(%ID_RMC1,1,1,aData(0),10) ' add the data to the series ... i = RMC_Draw(%ID_RMC1) ' ... and (re)draw the chart | ||