This is an old revision of the document!
A Cor4 belső függvényei
AddDataSource
void adddatasource(string name, string fields, string from, string where, string groupby, string having, string orderby)
Új adatforrást ad a megadott néven hozzá. A további paraméterek az SQL lekérdezés megfelelő részei.
Amennyiben már létezik ilyen, akkor egy ModifyDataSource() hívást eredményez.
AddElement
void addelement(int x,int y,array properties)
Ú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.
AddOpData
void addopdata(string key, mixed value)
Egyenértékű az OperationData[key] = value hívással. Használata kerülendő, mivel egyszerűen helyettesíthető és a régi webes CORE érdekesen hajtotta végre.
ArrayPrepare
mixed arrayprepare(mixed param)
Elavult függvényhívás! 1)
Jelen megvalósításban a paramétert változatlanul visszaadja.
CreateShortCut
void createshortcut(int shift_state,int key_code,string condition,string jumpto)
A függvény új gyorsbillentyűt hoz létre. A megadott shift_state-key_code lenyomása esetén a condition paraméterben átadott kifejezés kiértékelésre kerül, és amennyiben az értéke igaz, akkor a jumpto paraméterben megadott helyre átugrik a vezérlés.
A függvényhez a következő konstansokat lehet használni:
- VK_SHIFT: shift
- VK_CTRL: ctrl
- VK_ALT: alt
Valamint:
- VK_TAB Tab key
- VK_RETURN Enter key
- VK_ESCAPE Esc key
- VK_SPACE Space bar
- VK_PRIOR Page Up key
- VK_NEXT Page Down key
- VK_END End key
- VK_HOME Home key
- VK_LEFT Left Arrow key
- VK_UP Up Arrow key
- VK_RIGHT Right Arrow key
- VK_DOWN Down Arrow key
- K_INSERT Insert key
- VK_DELETE Delete key
- VK_NUMPAD0 0 key (numeric keypad)
- VK_NUMPAD1 1 key (numeric keypad)
- VK_NUMPAD2 2 key (numeric keypad)
- VK_NUMPAD3 3 key (numeric keypad)
- VK_NUMPAD4 4 key (numeric keypad)
- VK_NUMPAD5 5 key (numeric keypad)
- VK_NUMPAD6 6 key (numeric keypad)
- VK_NUMPAD7 7 key (numeric keypad)
- VK_NUMPAD8 8 key (numeric keypad)
- VK_NUMPAD9 9 key (numeric keypad)
- VK_MULTIPLY Multiply key (numeric keypad)
- VK_ADD Add key (numeric keypad)
- VK_SEPARATOR Separator key (numeric keypad)
- VK_SUBTRACT Subtract key (numeric keypad)
- VK_DIVIDE Divide key (numeric keypad)
- VK_F1 F1 key
- VK_F2 F2 key
- VK_F3 F3 key
- VK_F4 F4 key
- VK_F5 F5 key
- VK_F6 F6 key
- VK_F7 F7 key
- VK_F8 F8 key
- VK_F9 F9 key
- VK_F10 F10 key
- VK_F11 F11 key
- VK_F12 F12 key
DelOpData
void delopdata(string key [, string subkey])
Egy paraméterrel meghíva a hatása megegyezik az unset(OperationData[key]) hívással, míg két paraméter esetén egyenértékű az unset(OperationData[key][subkey]) hívással.
Igazából erre a függvényre sincs szükség az egyszerű helyettesíthetőség miatt.
DisableElement
void disableelement(string element)
A paraméterként megadott elemet disabled (tiltott) állapotba hozza. A WEB-es CORE csak az onLoad handlerben képes erre a műveletre, a natív kliensben ilyen megszorítás nincs!
EnableElement
void enalbeelement(string element)
A paraméterként megadott elemet enabled (engedélyezett) állapotba hozza. A WEB-es CORE csak az onLoad handlerben képes erre a műveletre, a natív kliensben ilyen megszorítás nincs!
EndAllOperation
void endalloperation()
Minden nyitott (sub)operation-t lezár. Ezt a függvényt főleg a menübe/főmenübe visszatérő handler-ekben használjuk, amikor le kell zárni az esetlegesen nyitott suboperation-okat. Az éppen aktuálisan nyitott operation is lezáródik.
EndOperation
void endoperation()
Az éppen aktuálisan nyitott operation-t lezárja. Ezzel nem törlődnek az OperationData tömb elemei, csak nem lesznek átvíve a következő handler-be.
Execute
void execute(string cmdline)
Csak a natív verzióban létezik!
A paraméterben megadott (Windows®-os) programot végrehajtja. Hasznos ilyenkor az INTERPRETER konstans ismerete, amely a jelenleg futó program teljes elérési útját tartalmazza.
FillForm
void fillform()
Az OperationData alapján kitölti a form mezőit. A gombnyomáskor automatikusan lefutó értékadás (amely az OperationData-ba másolja a form adatait) ellentettje.
GetNumAsText
string getnumastext(int num)
A megadott számot a langpack-ban definiált módon szövegesen adja vissza.
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ó.
GetValue
mixed getvalue(string element)
A függvény a form egy elemének értékét adja vissza. Ritkán használt, mert a rendszer az értékeket minden gombnyomáskor automatikusan az OperationData-ba másolja.
Egyetlen esetben van értelme használni, éspedig a list tipusnál a listában lévő elemek tömbjét adja vissza.
Insert
void insert(string filename)
A megadott file-t includolja. Hatása teljesen megegyezik az include PHP utasítással, de az itt nem alkalmazható.
A filename relatív címet kell tartalmazzon az alkalmazás gyökeréhez viszonyítva.
ModifyDataSource
void modifydatasource(string name, string fields, string from, string where, string groupby, string having, string orderby)
Módosítja a megadott nevű adatforrást. A további paraméterek esetén amennyiben a paraméter '_', az a paraméter változatlan marad. Amennyiben a paraméter '+' jellel kezdődik, akkor a megadott szöveget hozzáfűzi az eddigi értékhez (természetesen a '+' jel nélkül és a megfelelő SQL szintaxissal pl: ha a where paraméter '+id=2', akkor amennyiben a where paraméter eddig nem volt üres, akkor egy 'and id=2' szöveget fűz hozzá)
Amennyiben a megadott néven nem létezik még adatforrás egy AddDataSource hívást kezdeményez.
Hatása teljes mértékben megegyezik az AddDataSource függvény hívásával.
SetProgress
void setprogress(int percent)
Megjelenít egy progressbar-t a képernyő közepén a megadott százalékkal. 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.
Szépséghibája, hogy ha leváltunk a programról, akkor visszaváltani így sem lehet.
SetTitle
void settitle(string title)
Beállítja az oldal címét.