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

TrnNew

Creates a new trend at run time. This function performs the same operation as an entry in the Page Trends database. After the trend is created by the TrnNew() function, all the other trend functions can access and control the trend.

Syntax

TrnNew(AN, Trend [, Tag1 ... Tag8] [, ClusterName] )

AN:

The AN where the bottom right-hand corner of the trend is located.

Trend:

The trend definition number (as a STRING).

Tag1 . . .Tag8:

The trend tags. (These tags cannot be prefixed with cluster name, cluster should be specified with the ClusterName argument).

ClusterName:

The name of the cluster in which all the trend tags reside. This is optional if you have one cluster or are resolving the trends via the current cluster context. The argument is enclosed in quotation marks "".

Return Value

0 (zero) if successful, otherwise an error is returned.

Related Functions

TrnDelete

Example

TrnNew(20,"trn002","PV1","OP1", "ClusterXYZ");
/* Creates a new trend at AN20 using trend definition 2, plotting "PV1" on Pen1 and "OP1" on Pen2. */

See Also

Trend Functions