Creates a new RSCharts.TRSShapeChartValue instance and adds it to the Items array. The new instance is initialized with the dimensions (Top, Left, Width, and Height), Caption, Color, and ImageIndex parameters. Call Add to create a shape value in the collection. The new value is placed at the end of the Items array, or, if the collection is Sorted, placed at the sorted point in the collection (based on a default value (0)).
Add returns the new shape value.
Namespace: RSCharts
Delphi
|
public
function Add( ARect: TRSRect; Style: TRSShapeStyle = ssRectangle; Caption: String = ''; Color: TCanvasColor = clxDefaultColor; ImageIndex: Integer = -1 ): TRSShapeChartValue; overload;
|
Parameters
ARect
Type: TRSRect
Style
Type: TRSShapeStyle
Caption
Type: String
Color
Type: TCanvasColor
ImageIndex
Type: Integer
Return Value
Type: TRSShapeChartValue
The following example creates values in the collection:
Delphi
|
var
Value: TRSShapeChartValue; // note, this type should be the same that the chart uses (e.g., TRS2DChartValue, TRSArrowChartValue, etc)
begin
Value := MyChart.Values.Add;
Value.Caption := 'One';
Value.Color := clRed;
Value.X := 10.0;
Value.Y := 20.0;
Value.Width := 30;
Value.Height := 40;
Value.ImageIndex := 0;
// this code adds the same point but much more quickly
Value := MyChart.Values.Add( RSRect(10.0, 20.0, 30.0, 40.0), 'One', clRed, 0 );
end;
|
|
Reference
| • | TRSShapeChartValues.Add(TRSChartValueType,string,TCanvasColor,Integer) |
| • | TRSShapeChartValues.Add(TRSChartValueType,TRSChartValueType,string,TCanvasColor,Integer) |
|
