Funkcie %HI_SetGraphData a %HI_AddGraphData

%HI_SetDiagramData

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.

%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] )

refId	Odkaz na zobrazovač (referenčná premenná).
index	Poradové číslo grafického priebehu.
refToCol	Odkaz na stĺpec lokálnej premennej typu Record. Časové značky v poli musia byť usporiadané vzostupne.
step	Nepovinný parameter.
bStart	Nepoužitý parameter.
useAxisNr	Ak 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í.

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é.

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