Akcia SETDT_LINEOBJ

Funkcia
Akcia pripojí daný objekt do grafu.
Deklarácia
SETDT_LINEOBJ graph, lineNr, newObj, [retCode], [axisNr], [bSilent]

 
alebo
 
 HI_SETDT_LINEOBJ graph_RefId, lineNr, newObj, [axisNr], [bSilent]

Parametre
graph in Odkaz na objekt typu Graf.
graph_RefId in Hodnota referenčnej premennej priradenej grafickému objektu typu Graf.
lineNr in Identifikátor typu Int - číslo priebehu.
newObj in Odkaz na objekt alebo odkaz na jednu archívnu hodnotu.
axisNr in Typu Int - číslo osi, ktorá bude priradená danému priebehu.
Ak nie je uvedený (alebo má hodnotu -1), číslo osi sa v konfigurácii grafu nezmení.
retCode out Nepovinný identifikátor typu Int - návratový kód.
bSilent in Nepovinný identifikátor typu Bool.

Pre akciu SETDT_LINEOBJ:
Ak nie je uvedený (alebo má hodnotu @FALSE), systém zmenu automaticky oznámi bežiacim procesom D2000 HI, ktoré následne menený graf znovu otvoria podľa novej konfigurácie. Ak je hodnota parametra @TRUE, zmena konfigurácie grafu prebehne bez tejto automatickej aktualizácie.

Pre akciu HI_SETDT_LINEOBJ:
Ak je @TRUE, tak sa vykoná len nastavenie v grafe bez vyžiadania hodnôt priebehu z archívu. Ak parameter nie je uvedený alebo je @FALSE, tak sa vykoná nastavenie a vyžiadajú sa dáta z archívu.

Význam použitia: Vtedy, keď nasleduje príkaz požadujúci nové údaje z archívu, napr. zmena časového intervalu.

Popis
Akcia pripojí objekt (alebo položku štruktúrovaného archívu) daný parametrom newObj na priebeh (čiaru) v grafe. Poradové číslo čiary je dané parametrom lineNr. Menený priebeh musí existovať, akcia nevie zväčšovať ich počet.

Ak nie je použitý parameter retCode, akcia generuje len požiadavku na zmenu a nečaká na jej skutočné vykonanie. Ak sa parameter použije, je možné testovať úspešnosť operácie (_ERR_NO_ERROR).

Akcia je k dispozícii v dvoch variantách:

  • SETDT_LINEOBJ - modifikácia grafu v konfigurácii aplikácie. Zmeny sa ukladajú do konfiguračnej databázy a sú permanentné. Akcia je prípustná v kontexte objektu typu Event a aj v skripte aktívnej schémy.
  • HI_SETDT_LINEOBJ - modifikácia otvoreného grafu, ktorý je zobrazený v rámci schémy v zobrazovači typu Graf. V tomto prípade je zobrazovač daný hodnotou prvého parametra akcie. Vykonané zmeny konfigurácie sú dočasné a zaniknú v momente zatvorenia príslušného grafu (grafickej schémy).

Upozornenie:
Zmena konfigurácie cez SETDT_LINEOBJ bez čakania na výsledok operácie môže kolidovať s nasledovnými príkazmi skriptu pre graf.

Napríklad: 

 SETDT_LINEOBJ D.Test, 1, Min 
 %HI_SetGraphTimes(_Graph, _BT, _ET, @TRUE)

môže spôsobiť, že čas v grafe je nastavený ešte pred následným príchodom zmeny konfigurácie, ktorá nastavuje časy podľa definície grafu.


Príklad
Príklad predpokladá existenciu objektu D.Graf typu Graf.
 
 INT _retCode
 
 SETDT_LINEOBJ T.Graf, 2, Sec, _retCode
 ; test úspechu akcie
 IF _retCode = _ERR_NO_ERROR THEN
   ; zmena prebehla
 ELSE
   ; chyba
 ENDIF
 
 ; odpojenie objektu 
 ALIAS _empty
 SETDT_LINEOBJ D.Graf, 2, _empty 
 
 ; pripojenie objektu Sec na 3-ti priebeh v grafe T.Graf, pričom číslo osi bude 5 
 ; akcia nečaká na jej skutočné vykonanie 
 SETDT_LINEOBJ T.Graf, 3, Sec,, 5

 ; akcia počká na jej skutočné vykonanie, zmena konfigurácie prebehne nenápadne
 SETDT_LINEOBJ T.Graf, 3, Sec,  _retCode, 5, @TRUE

Súvisiace stránky:

Akcie v skriptoch
Funkcie pre ovládanie Grafických objektov (GO)

Napíšte komentár