guiGraphSetMarker (Function)

This function controls the horizontal markers on the graph.

The markers can be used to e.g. show maximum or minimum temperatures that the readings should not exceed.

Input:

graph : SYSHANDLE

The handle to the graph to set the marker on.

marker : INT (1..4) default 1

The marker to update.

value : INT default 0

The value of the marker, determining the horizontal position.

enable : BOOL default TRUE

Set to TRUE to show the marker, set to FALSE to hide it.

Returns: INT

Declaration:

FUNCTION guiGraphSetMarker : INT;
VAR_INPUT
  graph  : SYSHANDLE;
  marker : INT := 1;
  value  : INT := 0;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
VAR
  rc     : INT;
  graph  : SYSHANDLE;
END_VAR;
 
BEGIN
  ...
  // Show a marker at 40
  rc := guiGraphSetMarker(graph := graph, marker := 1, value := 40);
  // Show a marker at -20
  rc := guiGraphSetMarker(graph := graph, marker := 2, value := -20);
  ...
END;
END_PROGRAM;