buttons.md 4.9 KB

Gombok

Kapcsoló

Ez egy speciális mező, amit egy tároló mezőnek kell követnie, és annak a tároló mezőnek a láthatóságát kapcsolja. Ha a következő mező mégsem tároló lenne, akkor a form->value egy index az ui_event()-nek átadott űrlap elemeire. Ha a form->label 0, akkor a form->ptr egy nullával lezárt UTF-8 sztringre kell mutasson, ami cimkeként jelenik meg. Alapból ez elé a cimke elé kerül egy jobbra vagy lefelé nyíl, hacsak nincs UI_NOBULLET megadva, ekkor ugyanis nincs nyíl, helyette a cimke más színnel jelenik meg (lásd [színtéma], ez a menüelemekhez kell).

Paraméter Leírás
form->type UI_TOGGLE
form->flags Esetleg UI_NOBULLET
form->label Lokalizált sztringtömb indexe (vagy 0)
form->ptr Csak ha label 0, mutató egy sztringre
form->value Ha nem tároló követi, ui_event() űrlap indexe

Pipa

Kirajzol egy pipát cimkével. A mutatott érték jelzi, hogy be van-e pipálva. Ha rákattintanak, akkor a value int érték XOR-olódik a megadott címen lévő értékkel.

Paraméter Leírás
form->type UI_CHECK
form->flags Esetleg UI_NOBULLET
form->ptr Mutató az int értékre
form->value A gomb bitmaszkja
form->label Lokalizált sztringtömb indexe

Választó

Kirajzol egy választót cimkével. A mutatott érték jelzi, hogy ez-e az aktív. Ha rákattintanak, akkor a value int érték kerül a megadott címre.

Paraméter Leírás
form->type UI_RADIO
form->flags Esetleg UI_NOBULLET
form->ptr Mutató az int értékre
form->value A gomb int értéke
form->label Lokalizált sztringtömb indexe

Gomb

Kirajzol egy gombot. A mutatott érték jelzi, hogy be van-e nyomva. Ha rákattintanak, akkor a value int érték kerül a megadott címre. Lehet ikonja is, cimkéje is, vagy akár mindkettő. Ha bőrrel van rajzolva, akkor ott lehet árnyék, ami függőlegesen eltolja a cimkét. Ha ez előfordulna, akkor az m margóval igazítható (lehet negatív is).

Paraméter Leírás
form->type UI_BUTTON
form->flags Esetleg UI_NOBORDER
form->ptr Mutató az int értékre
form->value A gomb int értéke
form->label Lokalizált sztringtömb indexe
form->icon Mutató egy ui_image_t struct-ra
form->m Felső margó, ha bőrözött

Gombkapcsoló

Kirajzol egy gombot, ami [kapcsoló]ként viselkedik. Ha rákattintanak, akkor a mutatott tároló mező láthatóságát kapcsolja. Ha a ptr értéke NULL, akkor a form->value egy index az ui_event()-nek átadott űrlap elemeire.

Paraméter Leírás
form->type UI_BTNTGL
form->flags Esetleg UI_NOBORDER
form->ptr Mutató egy ui_form_t tároló mezőre
form->value Ha a ptr NULL, ui_event() űrlap indexe
form->label Lokalizált sztringtömb indexe
form->icon Mutató egy ui_image_t struct-ra
form->m Felső margó, ha bőrözött

Ikongomb

Kirajzol egy ikont, ha be van pipálva, egyébként semmit. Ha rákattintanak, akkor a value int érték XOR-olódik a megadott címen lévő értékkel. Pontosan úgy működik, mint a [pipa].

Paraméter Leírás
form->type UI_BTNICN
form->ptr Mutató az int értékre
form->value A gomb bitmaszkja
form->icon Mutató egy ui_image_t struct-ra