guiGraphScrollNext (Function)

This function appends the values set with guiGraphSetBar and guiGraphSetLinePoint with an x of -1 to the graph.

If no value is set for the bar, it will not be shown.

If no value is set for a point on one of the lines, it will be skipped, making the line continue directly to the next valid point, once it has been added.

Input:

graph : SYSHANDLE

The handle to the graph to append the items to.

Returns: INT

Declaration:

FUNCTION guiGraphScrollNext : INT;
VAR_INPUT
   graph : SYSHANDLE;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
VAR
   rc    : INT;
   graph : SYSHANDLE;
END_VAR;
 
BEGIN
   ...
   // Set the next bar to have the value 12
   rc := guiGraphSetBar(graph := graph, y:=12);
   // Set the next point on line 1 to 20
   rc := guiGraphSetLinePoint(graph := graph, line := 1, y := 20);
   // Append the new bar and point on the line to the graph.
   rc := guiGraphScrollNext(graph := graph);
   ...
END;
END_PROGRAM;