| RMC_AddGridlessSeries function. | ||
| Add a gridless chart to a region of an existing chart | ||
| Syntax | ||
| nResult (LONG) = RMC_AddGridlessSeries( ByVal nCtrlId (LONG), ByVal nRegion (LONG), Optional ByRef nFirstDataValue (DOUBLE), Optional ByVal nDataValuesCount (LONG), Optional ByRef nFirstColorValue (LONG), Optional ByVal nColorValuesCount (LONG), Optional ByVal nStyle (LONG), Optional ByVal nAlignment (LONG), Optional ByVal nExplodemode (LONG), Optional ByVal nIsLucent (LONG), Optional ByVal nValueLabelOn (LONG), Optional ByVal nHatchMode (LONG), Optional ByVal nStartAngle (LONG) ) |
||
| Parameter | ||
| nCtrlId (LONG) | ||
| Unique ID of the chart control, to which the series belongs. | ||
| nRegion (LONG) | ||
| Region to which the series belongs. | ||
| nFirstDataValue (DOUBLE) | ||
| The first element of an one-dimensional array, which holds the series data. If you want to add the data later with RMC_SetSeriesData(), simply pass 0. | ||
| nDataValuesCount (LONG) | ||
| The total number of elements in the data array or zero, if you want to add the data later. | ||
| nFirstColorValue (LONG) | ||
| The first element of an one-dimensional array with color values as Color....constants or as a RGB value. If you want to use the internal color table (up to nine differnet colors), simply pass a 0. If you want to use your own color values, the size of the color array must match the size of the data array: for each data point you must define a color value. | ||
| nColorValuesCount (LONG) | ||
| The total number of elements in the color array. If you want to use the internal color table, simply pass a 0. | ||
| nStyle (LONG) | ||
| Style as a chart style constant. If omitted or 0: RMC_PIE_FLAT | ||
| nAlignment (LONG) | ||
| Alignment as a pie alignment constant. If omitted or 0: RMC_FULL (regards only RMC_PIE... and RMC_DONUT... charts, not RMC_PYRAMIDE or RMC_PYRAMIDE3) | ||
| nExplodemode (LONG) | ||
| If -1, the smallest pie or donut slice, if -2 the biggest slice, if greater than 0, the equivavlent slice will be painted "exploded". If omitted or 0: nothing explodes. (Affects only RMC_PIE... and RMC_DONUT... charts, not RMC_PYRAMIDE..) | ||
| nIsLucent (LONG) | ||
| If TRUE, the transparency is switched on, if FALSE not. If omitted or 0: FALSE. Transperancy is reasonable only for type RMC_PIE_3D... or RMC_DONUT_3D..., with the other styles transparency has no special effect. | ||
| nValueLabelOn (LONG) | ||
| You can show value labels for each segment with the constant
RMC_VLABEL_DEFAULT or RMC_VLABEL_PERCENT, which both show the percent values, or with RMC_VLABEL_ABSOLUTE,
which shows the absolute values, or with RMC_VLABEL_TWIN, which shows both, the percent and the absolute values.
If you added a legend to your chart and choosed as legend alignment RMC_LEGEND_ONVLABELS, but want only the legend texts and no values on the labels, choose RMC_VLABEL_LEGENDONLY for the value labels. If omitted or 0: RMC_VLABEL_NONE. | ||
| nHatchMode (LONG) | ||
Normally solid colors are used to fill the segments of the gridless series.
It might be usefull (specially when printing) to fill the segments with a hatch brush instead
of a solid brush. In this case use this parameter. There are three possible values:
| ||
| nStartAngle (LONG) | ||
| In case of 2D Pies or Donuts, you can define the start angle for the first slice, in degrees from 0 (which is default) to 360 (which is the same as 0). | ||
| 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_MAXREGION | ||
| The region index exceeds the maximum possible numbers of regions (6) within a chart control. | ||
| RMC_ERROR_WRONGREGION | ||
| The region index is inexistent in the chart control. | ||
| RMC_ERROR_ALLOC | ||
| Error while allocating memory for the data. | ||
| Remarks | ||