| RMC_SetLAXLabelsRange function. | ||
| Sets the range within the labels block of a label axis | ||
| Syntax | ||
| nResult (LONG) = RMC_SetLAXLabelsRange( ByVal nCtrlId (LONG), ByVal nRegion (LONG), ByVal nFirst (LONG), ByVal nLast (LONG) ) | ||
| Parameter | ||
| nCtrlId (LONG) | ||
| Unique ID of the chart control, to which the axis belongs. | ||
| nRegion (LONG) | ||
| Index of the region, to which the axis belongs. | ||
| nFirst (LONG) | ||
| Index of the first label within the label block, which shall be included, first label has index 1. See also Remarks! | ||
| nLast (LONG) | ||
| Index of the last label within the label block, which shall be included. See also Remarks! | ||
| 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_NODATA | ||
| The axis has no labels. | ||
| Remarks | ||
|
With this function scrolling the labels (in conjunction with a huge data amount) is very easy. You can add all labels
at once (e.g. reading them from a file with RMC_SetLAXLabelsFile()),
then setting the range of the labels to be shown while your user scrolls through the chart.
Note: If both parameters nFirst and nLast are -1, all labels will be excluded, if both parameters are 0, a previously defined range gets anulled, i.e. all labels will be included. | ||
| Example | ||
i = RMC_AddLabelAxis(%ID_RMC,1,"",0,50) ' Add a label axis with no labels and 50 ticks (columns) on it i = RMC_SetLAXLabelsFile(%ID_RMC,1,"labels.csv","1000","1") ' Set the label file, line 1 to 1000, field 1 i = RMC_AddLineSeries(%ID_RMC,1,aData(0),1000) ' Add a line series with 1000 data points i = RMC_SetSeriesDataRange(%ID_RMC1,1,1,1,50) ' Include only the first 50 data points into the chart i = RMC_SetLAXLabelsRange(%ID_RMC1,1,1,50) ' Show the the first 50 labels on the label axis i = RMC_Draw(%ID_RMC1) ' Draw the chart initially ... ... ... ' later, for example when the user clicked a scroll bar: i = RMC_SetSeriesDataRange(%ID_RMC1,1,1,51,100) ' Show the next 50 data points ... i = RMC_SetLAXLabelsRange(%ID_RMC1,1,51,100) ' ...show the next 50 labels on the label axis ... i = RMC_Draw(%ID_RMC1) ' ...and redraw the chart | ||