CimData.Item (property)

Gets and sets the data value at the specified index.

Syntax:

VARIANT = object.Item ( Index )
object.Item ( Index ) = VARIANT

Parameters:

Index As VARIANT - Specifies the index of the item you desire.

Description:

CimData.Item allows you to get or set a specific data value. The data value is determined by the specified index argument.

If the argument is not provided, the property behaves like the Value property; it gets or sets the entire vector of data values.

This is the default property of CimData.

Examples

The following CimView script excerpt sets a variable to the 10th (index 9) X data value:
Dim value as Variant
value = cimOleObj.Series("Series 1").Data.X.Item(9)

The following CimView script excerpt also sets a variable to the 10th (index 9) X data value. However, it ommits using Item because it is the default property:
Dim value as Variant
value = cimOleObj.Series("Series 1").Data.X(9)

The following CimView script excerpt sets the 10th (index 9) X data value to 100.57:
cimOleObj.Series("Series 1").Data.X(9) = 100.57

The following CimView script excerpt sets the 10th (index 9) X data value to unavailable:
cimOleObj.Series("Series 1").Data.X.Item(9) = Empty

The following CimView script excerpt sets the 10th (index 9) X data value to a numerical string of value 5.7:
cimOleObj.Series("Series 1").Data.X(9) = "5.7"

The following CimView script excerpt gets a series X vector:

Dim x as Variant
x = cimOleObj.Series("Series 1").Data.X

The following CimView script excerpt sets a series X vector to a 5-element array of integers:

Dim x(4) as Integer
x(0) = 1
x(1) = 2
x(2) = 3
x(3) = 4
x(4) = 5
cimOleObj.Series("Series 1").Data.X = x