Int type - number of axis associated to
given process. If number is not specified (or its value is -1),
number of axis will not be changed in graph configuration.
retCode
out
Optional identifier of Int type - return code.
bSilent
in
Optional identifier of Bool type.
SETDT_LINEOBJ action:
If it is not written or it is @FALSE, the system informs
the running processes of D2000 HI about the change. The processes
open graph again according to new configuration.
If the parameter is @TRUE, the change of graph configuration
will be done without this automatic update.
HI_SETDT_LINEOBJ:
If the parameter is @TRUE only the setting in graph will be done
without calling the values of progress from archive. If it is not
written or it is @FALSE, the setting is done and data are required
from archive.
Description
The action will connect the object (or structured archive item) given by the parameter newObj, to
the given flow (line) in the graph. The modified flow must exist,
because the action is not able to increase their number.
If the parameter retCode is not used, the action generates only
the request for a change and does not wait for its real execution. If it is
used, it is possible to test the action success (_ERR_NO_ERROR).
The action can be of two
versions:
SETDT_LINEOBJ - the graph change in
configuration of application. The changes are saved into the
configuration database and they are lasting. The action can be used in
object of Event type and in script of picture.
HI_SETDT_LINEOBJ
- the change of opened graph which is displayed in displayer of
Graph type in picture. In this case, it is determined by the value of the first
parameter. The changes are temporary and they will be taken off when the
graph (picture) is closed.
Warning:
The configuration change by SETDT_LINEOBJ without waiting on result
of the operation can collide with following script commands for graph.
For example:
SETDT_LINEOBJ D.Test, 1, Min
%HI_SetGraphTimes(_Graph, _BT, _ET, @TRUE)
can caused that time is set before coming the configuration change which
sets time according to graph definition.
Example
The example assumes existence of the object D.Graph of GRAPH type.
INT _retCode
SETDT_LINEOBJ D.Graph, 2, Sec, _retCode
; Action success test
IF _retCode = _ERR_NO_ERROR THEN
; Change executed
ELSE
; Error
ENDIF
; Disconnecting the object
ALIAS _empty
SETDT_LINEOBJ D.Graph, 2, _empty
; Connecting of object Sec on the third process in graph T.Graf, where the number of axis is 5
; The action do not wait on its real executing
SETDT_LINEOBJ T.Graf, 3, Sec,, 5
; The action waits on its real executing, configuration change is made inconspicuously
SETDT_LINEOBJ T.Graf, 3, Sec, _retCode, 5, @TRUE