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

TrnGetEvent

Gets the event number of the trend at a percentage along the trend, using the current event as the base point. This function only operates on an event-based trend. The first recorded event (the start event) would be event number 1 and the highest number would be the latest event. The event number is stored in a LONG and would eventually wrap around if you have enough events.

Syntax

TrnGetEvent(AN, Pen, Percent)

AN:

The AN of the chosen trend.

Pen:

The trend pen number:

0 - The pen currently in focus

1...8 - Pen1. . .Pen8

Percent:

The percentage of the trend from the starting event, from 0 (the start event) to 100 (the end event).

Return Value

The event number.

Related Functions

TrnSetEvent, TrnGetCluster, TrnGetCursorEvent

Example

/* Display the start event for the current pen of the trend at 
AN20. */
DspText(31,0,TrnGetEvent(20,0,0));

See Also

Trend Functions