Cicode Programming Reference > Cicode Function Categories > Trend Functions Introduction > TrnGetPen

TrnGetPen

Gets the trend tag being plotted by a specified pen.

Syntax

TrnGetPen(AN, Pen [, Mode] )

AN:

The AN of the chosen trend.

Pen:

The trend pen number:

0 - The pen currently in focus

1...8 - Pen1. . .Pen8

Mode:

An optional argument used to specify whether the trend tag name is returned with a cluster prefix. Set:

Return Value

The trend tag (as a string) being plotted by Pen. If AN or Pen is invalid, an empty string is returned, and an error code is set. You can call the IsError() function to get the actual error code.

Related Functions

TrnSetPen

Example

! For the trend at AN20
DspText(31,0,TrnGetPen(20,0,1));
! Displays the trend tag with cluster prefix of the focus pen.

See Also

Trend Functions