Dundas Chart for Windows Forms
AddXY(Object,Object[]) Method
See Also  Send comments on this topic.
DundasWinChart Assembly > Dundas.Charting.WinControl Namespace > DataPointCollection Class > AddXY Method : AddXY(Object,Object[]) Method


xValue

The X-value of the DataPoint object added to the collection.


The X-value of the DataPoint object added to the collection.


X value of the data point.
yValue
The Y-value(s) of the DataPoint object added to the collection (one or more comma-separated values).
List of Y values of the data point.

Adds a DataPoint object to the end of the collection, with the specified X-value and Y-value(s).


The Y-value(s) of the DataPoint object added to the collection (one or more comma-separated values).


The Y-value(s) of the DataPoint object added to the collection (one or more comma-separated values).


Adds one data point with X value and one or more Y values.

Syntax

Visual Basic (Declaration)  
Public Overloads Function AddXY( _
   ByVal xValue As Object, _
   ByVal ParamArray yValue() As Object _
) As Integer
Visual Basic (Usage) Copy Code
Dim instance As DataPointCollection
Dim xValue As Object
Dim yValue() As Object
Dim value As Integer
 
value = instance.AddXY(xValue, yValue)
C#  
public int AddXY( 
   object xValue,
   params object[] yValue
)

Parameters

xValue

The X-value of the DataPoint object added to the collection.


The X-value of the DataPoint object added to the collection.


X value of the data point.
yValue
The Y-value(s) of the DataPoint object added to the collection (one or more comma-separated values).
List of Y values of the data point.

Return Value

Returns an integer that represents the index where the item was inserted into the collection (0-based).


Index of newly added data poit.

Remarks

This method adds one data point to the DataPointCollection object, always adding it to the end of the collection.

You must provide at least one (1) Y-value, otherwise an exception will be thrown. This method also checks the Type property of the Series object this data belongs to, and if too many Y-values are specified an exception will be thrown.

For DateTime formatting to have an effect a value must be a DateTime object.

If your data points do not need an X-value (e.g. if you are creating non-scatter plots) then use the AddY method instead.

Refer to the following for a complete listing of valid .NET types that can be used for the object type parameters:

String

DateTime

Double

Decimal

Single

Int32

UInt32

Int64

UInt64

 

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2009 All Rights Reserved.