A Cor4 megjelenítéssel kapcsolatos függvényei

A többi Cor4 függvény

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.

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.

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

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

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.

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

boolean getautohidestatusbar()

A SetAutoHideStatusBar függvénnyel beállított értéket kapjuk vissza segítségével.

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.

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

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

void messagebox(string message [, string caption = “Hiba”])

A megadott szöveggel és fejléccel üzenet ablakot jelenít meg.

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.

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.

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.

void sethourglass()

Homokórázást kezd. A homokórázásnak az eseménykezelők végén automatikusan vége van.

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.

void setstatusbar(mixed value)

Megjeleníti illetve elrejti az alkalmazás állapotsorát (StatusBar). A paraméterekkel szabályozhatjuk a megjelenítendő szöveget:

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));

void settitle(string title)

Beállítja az oldal címét.

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.