Chapter 10: Methods for Graphs in the DataWindow Control

SeriesName

Description

Obtains the series name associated with the specified series number.

Syntax

integer dwcontrol.SeriesName ( string graphcontrol, integer seriesnumber )

Argument	Description
dwcontrol	A reference to the DataWindow control containing the graph
graphcontrol	A string whose value is the name of the graph in the DataWindow control
seriesnumber	The number of the series for which you want to obtain the name

Returns

Returns the name assigned to the series. If an error occurs, it returns the empty string (""). If any argument’s value is NULL, SeriesName returns NULL.

Usage

Series are numbered consecutively, from 1 to the value returned by SeriesCount. When you delete a series, the series are renumbered to keep the numbering consecutive. You can use SeriesName to find out the name of the series associated with a series number.

Examples

Example 1

These statements store in the variable ls_SeriesName the name of series 5 in the graph gr_computers in the DataWindow control dw_equipment:

string ls_SeriesName

ls_SeriesName = &

		dw_equipment.SeriesName("gr_computers", 5)