You can control a trend's operation by using the trend functions. Citect SCADA has standard trend pages, so you would not normally use these low-level functions unless you want to define your own trend displays. You can control the movement of the trend cursor, trend scaling, and the definition of trend attributes (such as the trend starting time and sampling period). You can also create, and subsequently delete trends.
Following are functions relating to Trends:
|
Restores an old history file to the trend system. |
|
|
Closes a trend browse session. |
|
|
Gets the oldest trend entry. |
|
|
Gets the field indicated by the cursor position in the browse session. |
|
|
Gets the next trend entry in the browse session. |
|
|
Returns the number of records in the current browse session. |
|
|
Opens a trend browse session. |
|
|
Gets the previous trend entry in the browse session. |
|
|
Gets information about the trend that is being displayed at the AN point. |
|
|
Prints two trends (one overlaid on the other), each with up to four trend tags. |
|
|
Deletes a trend created by the TrnNew() function. |
|
|
Deletes an old history file from the trend system. |
|
|
Enables and disables the echo on the trend display. |
|
|
Stores event trend data and the associated time stamp in an event table and time table, for a specified trend tag. |
|
|
Stores event trend data and time data (including milliseconds) for a specified trend tag. |
|
|
Sets trend data from a table, for a specified trend tag. |
|
|
Sets event trend data and time data (including milliseconds) for a specified trend tag. |
|
|
Exports trend data to the clipboard. |
|
|
Exports trend data to a file in CSV (comma separated values) format. |
|
|
Exports trend data to a file in dBASE III format. |
|
|
Exports trend data to applications via DDE. |
|
|
Flushes the trend to disk. |
|
|
Gets the event number of a trend at an offset for a pen. |
|
|
Gets the trend time at an offset for a pen. |
|
|
Gets the trend value at an offset for a pen. |
|
|
Gets the name of the cluster the trend graph is associated with. |
|
|
Gets the event number of a trend at the trend cursor. |
|
|
Gets the time (in milliseconds from the previous midnight) at a trend cursor for a specified pen. |
|
|
Gets the position of the trend cursor. |
|
|
Gets the time/date at the trend cursor. |
|
|
Gets the current trend cursor value of a pen. |
|
|
Gets the current trend cursor value of a pen as a formatted string. |
|
|
Gets the default engineering zero and full scales of a trend tag. |
|
|
Gets the display mode of a trend. |
|
|
Gets the event number of a trend at a percentage along the trend. |
|
|
Gets the format of a pen. |
|
|
Returns the internally stored value for <GATED>. |
|
|
Returns the internally stored value for <TRN_NO_VALUES>. |
|
|
Gets the display mode of trends (historical or real-time). |
|
|
Gets the time (in milliseconds from the previous midnight) of the trend (plotted by a specified pen) |
|
|
Gets the trend tag of a pen. |
|
|
Gets the comment of a trend pen. |
|
|
Gets the number of the pen currently in focus. |
|
|
Gets the pen number of a pen name. |
|
|
Gets the display period of a trend. |
|
|
Gets the scale of a pen. |
|
|
Gets the scale of a pen as a formatted string. |
|
|
Gets the span time of a trend. |
|
|
Stores trend data in an array. |
|
|
Gets the time/date of a pen. |
|
|
Gets the data units of a trend pen. |
|
|
Gets the configured values of a trend tag. |
|
|
Determines whether a logged trend value is <VALID>, <GATED>, or invalid <TRN_NO_VALUES>. |
|
|
Creates a new trend at run time. |
|
|
Prints a plot of one or more trend tags. |
|
|
Prints a trend that is displayed on the screen. |
|
|
Gets the number of samples configured for the currently displayed trend. |
|
|
Scrolls a trend pen. |
|
|
Sets up a page for a trend. |
|
|
Moves the trend cursor a specified number of samples. |
|
|
Moves the trend cursor to the given x-axis position. |
|
|
Specifies how trend samples will be displayed on the screen. |
|
|
Sets the start event of a trend pen. |
|
|
Sets a trend pen to a new trend tag. |
|
|
Sets the pen focus. |
|
|
Sets the display period (time base) of a trend. |
|
|
Re-scales a pen. |
|
|
Sets the span time of a trend. |
|
|
Sets trend data from an array. |
|
|
Sets the starting time/date of a pen. |
The following trend functions are used on standard trend templates. Use these functions only if you create your own trend templates
(These functions are written in Cicode and can be found in the include project.)
|
Displays the Trend Comment for the currently selected pen. |
|
|
Displays a scale value for the current pen. |
|
|
Displays the tag name of the current pen. |
|
|
Displays the cursor time of the current pen. |
|
|
Displays the cursor value of the current pen. |
|
|
Gets the AN number of the trend under the mouse position. |
|
|
Displays a pop-up trend with the specified trend pens. |
|
|
Initializes the cursor and rubber-band features on a trend page. |
|
|
Sets the starting date for the pens on a trend. |
|
|
Sets the scale of one or more pens on a trend. |
|
|
Sets the span time of a trend. |
|
|
Sets the starting time for the pens on a trend. |
|
|
Sets a new sampling period for a trend. |
|
|
Displays a trend page (in a new window) with the specified trend pens. |
|
|
Zooms a trend in either one or both axes. |
See Also
Published June 2018