A Cor4 megjelenítéssel kapcsolatos függvényei
AddElement
void addelement(int x,int y,array properties [,mixed data])
Új elemet ad a screen-hez. Csak az OnLoad handlerben van hatása. Ha az x vagy az y paraméter kilóg a screenről, akkor automatikusan megnöveli a screen méretét. A data paraméterben átadott értéket ugyanúgy eltárolja, mintha a SetData függvénnyel tároltuk volna.
Ha subscreen-t szeretnénk hozzáadni, akkor a properties tömbben a TYPE paraméternek (amit mindenképpen meg kell adnunk) subscreen értéket kell adni.
AddElementTo
void addelementto(string screen,int x,int y,array properties [,mixed data])
Csak annyiban tér el az AddElement függvénytől, hogy a screen paraméterben meghatározott subscreenhez adja hozzá a komponenst.
Confirm
bool confirm(string message [, string caption = “Hiba”])
A megadott szöveggel és fejléccel kérdő üzenetet jelenít meg, rajta a szokásos OK / Cancel gombokkal. A visszaadott érték ennek megfelelően akkor true, ha az OK gombra kattintott a felhasználó.
DisableElement
void disableelement(string element)
A paraméterként megadott elemet disabled (tiltott) állapotba hozza. A SetElementAttribute(element,'DISABLED','1') utasítás alias-ának tekinthető.
DisplayMessage
void displaymessage(string message, string header [, string jumpto [, int duration = 1000 [, mixed param = NULL [, int width = 329 [, int height = 76]]]])
A tálca feletti üzenet ablakot jelenít meg a megadott üzenettel és fejléccel. Amennyiben a jumpto paraméter adott, akkor az üzenetre kattintáckor a megadott JumpTo ugrás hajtódik végre. A duration paraméterben az üzenet láthatóságának idejét adhatjuk meg ezredmásodpercben, a param-ban pedig a hívás paraméterét adhatjuk meg a SubOperation híváshoz hasonlóan. A width és height paraméterekben pedig a megjelenő ablak szélességét és magasságát adhatjuk meg.
EnableElement
void enalbeelement(string element)
A paraméterként megadott elemet enabled (engedélyezett) állapotba hozza. A SetElementAttribute(element,'DISABLED','0') utasítás alias-ának tekinthető.
GetAutoHideStatusBar
boolean getautohidestatusbar()
A SetAutoHideStatusBar függvénnyel beállított értéket kapjuk vissza segítségével.
GetFocus
string getfocus()
Visszaadja a híváskor aktuális elem nevét, ha van ilyen, ellenkező esetben üres stringgel tér vissza. OnLoad eseménykezelőben a visszatérési érték definiálatlan. A setfocus függvény ellentéte.
GetOriginalTitle
string getoriginaltitle()
Az eredeti form nevét adja vissza. Akkor hasznos, ha csak valamivel ki szeretnénk egészíteni a feliratot. A funkciójából következik, hogy nem módosítható.
GetTitle
string gettitle()
A függvény a form aktuális feliratát (fejlécét) adja vissza. A SetTitle függvénnyel módosítható.
MessageBox
void messagebox(string message [, string caption = “Hiba”])
A megadott szöveggel és fejléccel üzenet ablakot jelenít meg.
SetAutoHideStatusBar
void setautohidestatusbar(boolean value)
Amennyiben igazra állítjuk (ami az alapérték is), akkor a megjelenített állapotsor a következő kattintáskor eltűnik. Ha hamisra állítjuk, akkor addig nem tűnik el, amíg azt manuálisan nem tüntetjük el egy SetStatusBar(null) hívással.
SetElementAttribute
void setelementattribute(mixed control, string param, mixed value)
A control nevű elem param tulajdonságát állítja value-ra. Ha a control paraméter tömb, akkor a tömb minden elemét módosítja.
Ha SubScreen-en illetve PageControl-on lévő elemre szeretnénk hivatkozni, akkor a hivatkozásban az elem neve előtt ”.”-al elválasztva szerepelnie kell a szülő SubScreen/PageControl nevének is (pl: egyszeru.nev esetén az egyszeru a SubScreen/PageControl neve a nev pedig az azon szereplő komponens neve) Ha a PageControl-on/Subscreen-en újabb PageControl/Subscreen található, akkor természetesen azokat is szerepeltetni kell (pl: osszetett.cim.irszam) A hivatkozásban szerepelhet “*”, de csak teljes név helyett (tehát az osszetett.*.irszam megengedett, de az osszetett.cim.szla* nem), ekkor azon a pozíción bármi szerepelhet (pl: az osszetett.* minden az osszetett nevű PageControl-on/SubScreen-en szereplő komponensre vonatkozik, de magára az osszetett komponensre és a rajta szereplő PageControl-ok/SubScreen-ek PageControl-jaira/SubScreen-jeire nem, tehát az osszetett.cim.irszam komponensre nem, míg az osszetett.cim komponensre igen - akkor is, ha az SubScreen/PageControl)
Alapvetően a SCREEN_XML egyes elemeit állíthatjuk vele az OnLoad handlerből.
SetFocus
void setfocus(string name)
A megadott elemen lesz az input fókusz. Csak OnLoad eseménykezelőben van hatása. A getfocus függvény ellentéte.
SetHourGlass
void sethourglass()
Homokórázást kezd. A homokórázásnak az eseménykezelők végén automatikusan vége van.
SetProgress
void setprogress(int percent [, string caption = ””])
Megjelenít egy progressbar-t a képernyő közepén a megadott százalékkal. A második opcionális paraméter a progressbar fölött megjelenő feliratot definiálja.
Főleg lassú műveleteknél lehet hasznos, ha tudatni szeretnénk a felhasználóval, hogy azért még a gép dolgozik.
SetStatusBar
void setstatusbar(mixed value)
Megjeleníti illetve elrejti az alkalmazás állapotsorát (StatusBar). A paraméterekkel szabályozhatjuk a megjelenítendő szöveget:
| Paraméter típusa | A függvény lefutásának eredménye |
|---|
| NULL | az állapotsor elrejtése |
| ARRAY | a tömb egyes elemei jelentik az állapotsor egyes szekcióit; egy szekció is lehet egy tömb, ekkor a tömb első eleme jelenti a szekció szövegét, a második a szekció szélességét pixelben; ha a szekció nem tömb, akkor az a feliratának lesz tekintve és a szélesség konstans 100 pixel |
| egyébként | az állapotsor megjelenítése a paraméterben megadott kifejezés szöveges reprezentációjával |
Példa:
SetStatusBar('Egyszerű szöveg az állapotsorban'); SetStatusBar(array('Ezek a','szövegek','mindegyike','100 pixel','széles')); SetStatusBar(array(array('50 pixel',50),array('100 pixel',100),'ez is 100 pixel',array('200 pixel',200));
SetTitle
void settitle(string title)
Beállítja az oldal címét.
Splash
void splash(string filename, int time)
A megadott fájlban szereplő képpel feldob egy ablakot a megadott ideig. Amennyiben a második paramétere 0 vagy negatív, akkor nem tűnik el automatikusan, csak ha a felhasználó rákattint.