%HI_SetGraphData and %HI_AddGraphData functions

Old name
%HI_SetDiagramData
Function
The function %HI_SetGraphData sets the data to display in the displayer of Graph type (Control function).

The function %HI_AddGraphData adds data into a specific graphic flow.


Declaration
%HI_SetGraphData(
   INT in refId, 
   INT in index, 
       in refToCol, 
   INT in step, 
   INT in bStart
 )

 
 
 
%HI_AddGraphData(
   INT in refId,
   INT in index,
       in refToCol[,
   INT in step := 0]
 )

Parameters
refId Reference to graphic object (reference variable).
index Serial number of the graphic flow.
refToCol Reference to column of local variable of RECORD type.
step Optional parameter.
bStart Unused parameter.

Description
The graph must be placed in the picture, where the parameter refId is the reference variable of the graph. The parameter RefToCol is the reference to the structure column (item), that includes the data to display. Individual values in the structure column are forming a value array. Each of the values contains a timestamp used to display in the graph. These timestamps must be arranged upwardly.
The parameter step determines, whether the data in the graph considers to be periodical (value is defined in the time written in its timestamp). If the value of the parameter step=0, the values are displayed as non-periodical (change values).
The parameter bStart_Int is not used.

Data fulfilment can be used only for the graphic flows with defined alternate object - "*".

The function %HI_SetGraphData (unlike the %HI_AddGraphData function) deletes all the values of the flow first and then inserts the new ones.


Example
The following example reads values in last 10 minutes from the archive and displays them in the graph.
 
ENTRY sendData_OnClick
   INT  _retCode
   TIME _BT
   TIME _ET
 
   RECORD (SD.ArchVal) _data
 
   _ET := SysTime
   _BT := %SubTime(_ET, 10*60)
 
   GETARCHARR H.Sec, _data^Value, _data^Flags, _BT, _ET, 0, 1000, _retCode
 
   %HI_SetGraphData(_graf, 2, _data^Value)
   %HI_SetGraphInfo(_graf, 2, "Number of values = " + %IToStr(_data\DIM))
 
 END sendData_OnClick

Related pages:

Graphic object manipulation functions
Function arguments - types

Napíšte komentár