This is an old revision of the document!
Egy oldal megjelenését egy XML file írja le. Ez az XML nagyon egyszerű struktúrát ír le, mivel az alapkoncepció szerint az oldal csak egy egyszerű táblázatból állhat.
SCREEN
A gyökér elem.
ROW
A sorokat határolja a HTML-hez hasonlóan. Az oldal megjelenítéséért felelős elemek csak ezen belül lehetnek. (a natív kliens nem igényli a záró tagot, de azért érdemes kirakni)
CONTROL
Az oldal ilyen CONTROL-okból épül fel. A CONTROL egyetlen kötelező mezője a TYPE, amely megadja a CONTROL tipusát.
Minden CONTROL lehet vízszintesen és/vagy függőlegesen összevonva más cellákkal, ezt a HTML-hez hasonlóan a COLSPAN és ROWSPAN tulajdonsággal adhatjuk meg. Ezenkívül minden CONTROL rendelkezik igazítással, amellyel megadjuk, hogy a cellán belül merre történjen az igazítás. Ezt a HALIGN és VALIGN tulajdonsággal adhatjuk meg. A HALIGN a vízszintes igazításért felelős; lehetséges értékei: right, center, left. A VALIGN felelős a függőleges igazításért; lehetséges értékei: bottom, midle vagy center, top.
Minden CONTROL-hoz megadhatjuk a tőle függő elemeket a DEPENDENT tulajdonságban, amelyben a megfelelő elemek neveit kell vesszővel elválasztva felsorolni.
A következőkben a CONTROL tipusokat részletezem:
textfield, password
Egyszerű egysoros szövegbeviteli mező. A textfield és a password közötti egyetlen különbség, hogy a password esetében a beírt szöveg "kicsillagozódik". A lehetséges tulajdonságai:
- TEXT: a megjelenítendő szöveg
- MAXCHARNUMBER: a beírható karakterek maximális száma
- INPUTTYPE: a beviteli mező tipusa. Jelenleg a következő négy tipust támogatja a rendszer:
- numeric: csak számjegyet és egyetlen "."-ot lehet beírni
- integer: csak számjegyeket lehet beírni
- date: csak dátumot lehet beírni
- text: ez a legegyszerűbb, mivel azt írunk bele, amit akarunk
- DEPENDENT: a kapcsolódó mezőket adja meg. Hatása attól függ, hogy milyen elemre hivatkozik:
- LABEL: a felirat aláhúzott és ha valami okból a mező hibás (pl: nem töltöttük ki, hibás dátum stb.), akkor dőlt
- SUBMIT: csak akkor lesz aktív, ha az összes rá hivatkozó elem OK
label
Egy felirat az oldalon.
- CAPTION: a felirat szövege
- SIZE: a felirat karakter mérete (alapérték 8)
- STYLE: a felirat karakter stílusát állíthatjuk be vele. A tulajdonság sztring tipusú. A karakterek sorrendje lényegtelen. Az egyes karakterek jelentése a következő:
- B: félkövér (Bold)
- I: dőlt (Italic)
- U: aláhúzott (Underline)
- S: áthúzott (StrikeOut)
submit
Egyszerű nyomógomb, amely lehet szabványos Windows szerű, illetve egy képpel és egy felirattal reprezentált. Lehetséges tulajdonságai a következők:
- CAPTION: a gomb felirata
- HOTKEY: egyetlen karakter, amely a gyorsbillentyűt adja meg (nem használhatók ékezetes karakterek)
- URL, IMAGE: a használt kép elérési útja. Amennyiben az elérési út nem tartalmaz \ vagy / jelet, akkor a THEMES könyvtárhoz, ellenkező esetben az alkalmazás gyökér könyvtárához képest relatív
filename
Egy egyszerű egysoros beviteli mezőt jelenít meg mellette egy “Tallóz” feliratú gombbal, amivel egy fájlt lehet olvasásra betallózni. Ezzel tulajdonképpen egy fájl kijelölését végezhetjük el. Tulajdonságai nincsenek.
label
Egyszerű felirat. Lehetséges tulajdonságai a következők:
- CAPTION: a felirat
- SIZE: a felirat betűmérete. Alapérték: 8
- STYLE: a felirat betűstílusa. Szöveges mező, ahol a karakterek helye lényegtelen (azaz a “BIU” és az “UBI” egyenértékű). Lehetséges karakterek:
- “B”: félkövér Bold
- “I”: dőlt Italic
- “U”: aláhúzott Underline
- “S”: áthúzott StrikeOut
combobox,select
Legördülő lista. A két megnevezés egyenértékű. Lehetséges tulajdonságai a következők:
- SELECTED: a kiválasztott elem kódja
list
Szűrőtáblázat. A szűrési feltételnek megfelelően a szó kezdetére azonnal szűr. Amennyiben a szűrési feltétel “*” karakterrel kezdődik, akkor tetszőleges szövegrészletre szűr. Lehetséges tulajdonságai a következők:
- BUTTONS: a megjelenő gombok nevei vesszővel elválasztva
- HOTKEY: a gombok gyorsbillentyűi elválasztójel nélkül (azaz “tuv” azt jelenti, hogy az első gombnak “t” a gyorsbillentyűje, a másodiknak “u”, a harmadiknak pedig “v”)
- CRITERIA: megjelenjenek-e a szűrő mezők. Alapérték: 1
- FIELDS: a táblázat fejlécének feliratai vesszővel elválasztva
- WIDTH: a táblázat oszlopainak szélessége vesszővel elválasztva
- ROWS: a táblázat sorainak száma, a táblázat magassága ebből számolódik
- CAPTION: a táblázat felirata
- CHECKBOXES: ha ez nem üres, akkor multiselect lista lesz és a felsorolt feliratokkal gombok jönnek létre
- DATASOURCE: ha megadjuk, akkor az előtte definiált adatforrásból feltölti a listát; lényegesen gyorsabb, mintha ugyanezt handler-ből tennénk
date,datetime
Dátum választó input elem. Jelen megvalósításban a két megnevezés egyenértékű, de ez a későbbiekben változhat. Lehetséges tulajdonságai a következők:
- FIELD1, FIELD2, FIELD3: az egyes mezők tipusa. Alapérték rendre: year, month illetve daynumber. Lehetséges értékei:
- year: évszám
- month: hónap számmal
- monthname: hónap neve kiírva
- shortmonthname: hónap neve rövidítve
- daynumber: nap
- STARTYEAR: kezdő év. Alapérték: aktuális év minusz 5 év
- ENDYEAR: befejező év. Alapérték: aktuális év plusz 5 év
- YEAR: kiválasztott év
- MONTH: kiválasztott hónap
- DAY: kiválasztott nap
memo
Tetszőleges szöveg bevitelére alkalmas több soros beviteli mező. Lehetséges tulajdonságai a követlezők:
- VALUE: a mező értéke
checkbox
A nevének megfelelően egy checkbox-ot reprezentál. Lehetséges tulajdonságai a követlezők:
- CAPTION: felirat
- HOTKEY: a checkbox gyorsbillentyűje
- CHECKED: bepipált állapotban van, vagy sem
