Funkcie %HI_SetGraphData a %HI_AddGraphData

Starý názov funkcie
%HI_SetDiagramData


Funkcia

Funkcia %HI_SetGraphData nastaví dáta pre zobrazenie v grafe pripojenom k zobrazovaču  typu Graf (riadiaca funkcia).

Funkcia %HI_AddGraphData doplní dáta do daného grafického priebehu.


Deklarácia
%HI_SetGraphData(
   INT in refId,
   INT in index,
       in refToCol[,
   INT in step := 0,
   BOOL in bStart := @TRUE,
   INT in useAxisNr := 0]
 )
 


 


 


%HI_AddGraphData(
   INT in refId,
   INT in index,
       in refToCol[,
   INT in step := 0]
 )
Parametre
refIdOdkaz na zobrazovač (referenčná premenná).
indexPoradové číslo grafického priebehu.
refToColOdkaz na stĺpec lokálnej premennej typu Record. Časové značky v poli musia byť usporiadané vzostupne.
stepNepovinný parameter.
bStartNepoužitý parameter.
useAxisNrAk je hodnota uvedená a väčšia ako 0, priebehu bude priradená existujúca os v grafe. Ak hodnota nie je uvedená alebo je 0, os priradená k priebehu sa nezmení.
Popis
Graf musí byť umiestnený do schémy, kde mu je priradená referenčná premenná (refId).
Parameter index označuje poradové číslo grafického priebehu (číslovanie od 1).
Parameter RefToCol je odkaz na stĺpec (položku) štruktúry, ktorá obsahuje dáta pre zobrazenie. Jednotlivé hodnoty v stĺpci štruktúry vytvárajú pole hodnôt. Každá hodnota obsahuje časovú značku, ktorá je použitá pri zobrazovaní v grafe. Tieto značky musia byť usporiadané vzostupne.

Parameter step určuje, či sa budú hodnoty v grafe považovať za periodické (hodnota je definovaná len v čase, ktorý je zapísaný v príslušnej časovej značke). Ak step=0 (alebo nie je zadaný vôbec), hodnoty sú zobrazené ako neperiodické (zmenové).

Parameter bStart nie je použitý.

Plnenie dát je možné len pre tie priebehy (čiary), pre ktoré je nakonfigurovaný ako zobrazovací objekt tzv. náhradný objekt - "*".

Funkcia %HI_SetGraphData (na rozdiel od funkcie %HI_AddGraphData) všetky hodnoty daného priebehu najprv vymaže a potom vloží nové.

Príklad
Nasledujúci príklad prečíta hodnoty z archívu za posledných 10 minút a tieto následne zobrazí v grafe.


 


 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, "Pocet hodnot = " + %IToStr(_data\DIM))
 
 END sendData_OnClick

Súvisiace stránky:

Funkcie pre ovládanie grafických objektov
Argumenty funkcie - typy

Napíšte komentár