| RMC_AddRegion function. | ||
| Add a region to an existing chart | ||
| Syntax | ||
| nResult& = RMC_AddRegion( ByVal nCtrlId&, Optional ByVal nLeft&, Optional ByVal nTop&, Optional ByVal nWidth&, Optional ByVal sFooter$, Optional ByVal nShowBorder& ) |
||
| Parameter | ||
| nCtrlId& | ||
| Unique ID of the chart control, to which the region belongs. | ||
| nLeft& | ||
| Upper left corner of the region in the chart (in pixel). If omitted or 0: 1. | ||
| nY& | ||
| Top corner of the region in the chart (in pixel). If omitted or 0: 1 pixel. | ||
| nWidth& | ||
| Width of the region (in pixel). If this value is negative, it defines the offset from the right border of the chart control. If omitted or 0: -1 | ||
| nHeight& | ||
| Height of the region (in pixel). If this value is negative, it defines the offset from the bottom of the chart control. If omitted or 0: -1 | ||
| sFooter$ | ||
| Footer which will be painted in 7 point in the most lower, right edge of the region (e.g. for comments or data sources etc.). | ||
| nShowborder& | ||
| If TRUE, a border will be painted around the region. This can be usefull in design mode, when designing a chart with more then one region. If omitted or 0: FALSE (no border) | ||
| 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. | ||