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;