ChartDirector 7.0 (Perl Edition)

Layer.getDataSetByZ


Usage

getDataSetByZ(zIndex)

Description

Gets a DataSet object based on the order in which it is being drawn.

In certain layer types, the data sets are drawn in a certain order. For example, in a line layer, the data sets represent lines and they are drawn one by one. In contrast, for a candlestick layer, the high, low, open and close data sets are combined into candlestick symbols, and there is no specific order on which data sets are drawn.

This method can be used to get the data set based on the order it is being drawn. If the data sets are not drawn in any specific order, this method will return the data sets in the reverse order to which it is added to the layer.

Arguments

ArgumentDefaultDescription
zIndex(Mandatory)The z-index of the required data set. The z-index of the first data set drawn is 0. The z-index for the Nth data set drawn is N - 1.

Return Value

The DataSet object at the specified z-order.