Differences
This shows you the differences between two versions of the page.
|
cor4:app:functions:screen [2009/02/13 06:12] 127.0.0.1 external edit |
cor4:app:functions:screen [2021/01/05 11:39] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== A Cor4 megjelenítéssel kapcsolatos függvényei ====== | + | ====== A Cor4 megjelenítéssel kapcsolatos függvényei ====== |
| - | + | ||
| - | [[cor4|A többi Cor4 függvény]] | + | |
| - | + | ||
| - | ===== AddElement ===== | + | [[cor4|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|SetData]] függvénnyel tároltuk volna. | + | ===== AddElement ===== |
| - | + | ||
| - | 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 addelement(int x,int y,array properties [,mixed data])'' |
| - | + | ||
| - | ''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. | + | Ú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|SetData]] függvénnyel tároltuk volna. |
| - | + | ||
| - | ===== Confirm ===== | + | |
| - | + | ||
| - | ''bool confirm(string message [, string caption = "Hiba"])'' | + | 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. |
| - | + | ||
| - | 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 ===== | + | ===== AddElementTo ===== |
| - | + | ||
| - | ''void disableelement(string element)'' | + | |
| - | + | ||
| - | A paraméterként megadott elemet ''disabled'' (tiltott) állapotba hozza. A [[#setelementattribute|SetElementAttribute]]''(element,'DISABLED','1')'' utasítás alias-ának tekinthető. | + | ''void addelementto(string screen,int x,int y,array properties [,mixed data])'' |
| - | + | ||
| - | ===== DisplayMessage ===== | + | |
| - | + | ||
| - | ''void displaymessage(string message, string header [, string jumpto [, int duration = 1000 [, mixed param]]])'' | + | Csak annyiban tér el az [[#AddElement]] függvénytől, hogy a ''screen'' paraméterben meghatározott subscreenhez adja hozzá a komponenst. |
| - | + | ||
| - | 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 [[cor4_app:jumpto|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|SubOperation]] híváshoz hasonlóan. | + | |
| - | + | ||
| - | ===== EnableElement ===== | + | ===== Confirm ===== |
| - | + | ||
| - | ''void enalbeelement(string element)'' | + | |
| - | + | ||
| - | A paraméterként megadott elemet ''enabled'' (engedélyezett) állapotba hozza. A [[#setelementattribute|SetElementAttribute]]''(element,'DISABLED','0')'' utasítás alias-ának tekinthető. | + | ''bool confirm(string message [, string caption = "Hiba"])'' |
| - | + | ||
| - | ===== GetAutoHideStatusBar ===== | + | |
| - | + | ||
| - | ''boolean getautohidestatusbar()'' | + | 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ó. |
| - | + | ||
| - | A [[#setautohidestatusbar|SetAutoHideStatusBar]] függvénnyel beállított értéket kapjuk vissza segítségével. | + | |
| - | + | ||
| - | ===== GetFocus ===== | + | ===== DisableElement ===== |
| - | + | ||
| - | ''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 [[cor4#setfocus|setfocus]] függvény ellentéte. | + | ''void disableelement(string element)'' |
| - | + | ||
| - | ===== GetOriginalTitle ===== | + | |
| - | + | ||
| - | ''string getoriginaltitle()'' | + | A paraméterként megadott elemet ''disabled'' (tiltott) állapotba hozza. A [[#setelementattribute|SetElementAttribute]]''(element,'DISABLED','1')'' utasítás alias-ának tekinthető. |
| - | + | ||
| - | 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 ===== | + | ===== DisplayMessage ===== |
| - | + | ||
| - | ''string gettitle()'' | + | |
| - | + | ||
| - | A függvény a form aktuális feliratát (fejlécét) adja vissza. A [[cor4#SetTitle|SetTitle]] függvénnyel módosítható. | + | ''void displaymessage(string message, string header [, string jumpto [, int duration = 1000 [, mixed param = NULL [, int width = 329 [, int height = 76]]]])'' |
| - | + | ||
| - | ===== MessageBox ===== | + | |
| - | + | ||
| - | ''void messagebox(string message [, string caption = "Hiba"])'' | + | 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 [[cor4_app:jumpto|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|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. |
| - | + | ||
| - | A megadott szöveggel és fejléccel üzenet ablakot jelenít meg. | + | |
| - | + | ||
| - | ===== SetAutoHideStatusBar ===== | + | ===== EnableElement ===== |
| - | + | ||
| - | ''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|SetStatusBar(null)]] hívással. | + | ''void enalbeelement(string element)'' |
| - | + | ||
| - | ===== SetElementAttribute ===== | + | |
| - | + | ||
| - | ''void setelementattribute(mixed control, string param, mixed value)'' | + | A paraméterként megadott elemet ''enabled'' (engedélyezett) állapotba hozza. A [[#setelementattribute|SetElementAttribute]]''(element,'DISABLED','0')'' utasítás alias-ának tekinthető. |
| - | + | ||
| - | 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 [[cor4:app:screen_xml#screen|SubScreen-en]] illetve [[cor4:app:screen_xml#pagecontrol|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) | + | ===== GetAutoHideStatusBar ===== |
| - | + | ||
| - | Alapvetően a [[cor4:app:SCREEN_XML]] egyes elemeit állíthatjuk vele az OnLoad handlerből. | + | |
| - | + | ||
| - | ===== SetFocus ===== | + | ''boolean getautohidestatusbar()'' |
| - | + | ||
| - | ''void setfocus(string name)'' | + | |
| - | + | ||
| - | A megadott elemen lesz az input fókusz. Csak OnLoad eseménykezelőben van hatása. A [[cor4#getfocus|getfocus]] függvény ellentéte. | + | A [[#setautohidestatusbar|SetAutoHideStatusBar]] függvénnyel beállított értéket kapjuk vissza segítségével. |
| - | + | ||
| - | ===== SetHourGlass ===== | + | |
| - | + | ||
| - | ''void sethourglass()'' | + | ===== GetFocus ===== |
| - | + | ||
| - | Homokórázást kezd. A homokórázásnak az eseménykezelők végén automatikusan vége van. | + | |
| - | + | ||
| - | ===== SetProgress ===== | + | ''string getfocus()'' |
| - | + | ||
| - | ''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. | + | 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 [[cor4#setfocus|setfocus]] függvény ellentéte. |
| - | + | ||
| - | 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 ===== | + | ===== GetOriginalTitle ===== |
| - | + | ||
| - | ''void setstatusbar(mixed value)'' | + | |
| - | + | ||
| - | Megjeleníti illetve elrejti az alkalmazás állapotsorát (StatusBar). A paraméterekkel szabályozhatjuk a megjelenítendő szöveget: | + | ''string getoriginaltitle()'' |
| - | + | ||
| - | ^ 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 | | + | 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ó. |
| - | | egyébként | az állapotsor megjelenítése a paraméterben megadott kifejezés szöveges reprezentációjával | | + | |
| - | + | ||
| - | Példa: | + | |
| - | + | ===== GetTitle ===== | |
| - | <code php> | + | |
| - | 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)); | + | ''string gettitle()'' |
| - | </code> | + | |
| - | + | ||
| - | ===== SetTitle ===== | + | |
| - | + | A függvény a form aktuális feliratát (fejlécét) adja vissza. A [[cor4#SetTitle|SetTitle]] függvénnyel módosítható. | |
| - | ''void settitle(string title)'' | + | |
| - | + | ||
| - | Beállítja az oldal címét. | + | |
| - | + | ===== MessageBox ===== | |
| - | ===== Splash ===== | + | |
| - | + | ||
| - | ''void splash(string filename, int time)'' | + | |
| - | + | ''void messagebox(string message [, string caption = "Hiba"])'' | |
| - | 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. | + | |
| - | + | ||
| + | |||
| + | 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|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 [[cor4:app:screen_xml#screen|SubScreen-en]] illetve [[cor4:app:screen_xml#pagecontrol|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 [[cor4:app: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 [[cor4#getfocus|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: | ||
| + | |||
| + | |||
| + | |||
| + | <code php> | ||
| + | |||
| + | 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)); | ||
| + | |||
| + | </code> | ||
| + | |||
| + | |||
| + | |||
| + | ===== 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. | ||
| + | |||
| + | |||