Klávesové zkratky na tomto webu - základní
Přeskočit hlavičku portálu


Programování pro PalmOS počítače krok za krokem (19)

aktualizováno 
Základním prvkem uživatelského rozhraní Palm Pilota jsou formuláře. Proto si uvedeme seznam funkcí, které s formuláři pracují, a několik poznámek k jejich využití.

2.34 Funkce pro zpracování událostí ve formuláři

Ke každému formuláři, který v naší aplikaci použijeme, můžeme definovat funkci pro zpracování událostí, které se ho týkají a na které si přejeme reagovat (jeho zobrazení na obrazovce, zmáčknutí tlačítka apod.). Této funkci říkáme funkce formuláře.

Této funkci je systémem předána zpráva o události (prostřednictvím ukazatele na strukturu EventType, ve které je zpráva o události uložena). Pokud naše funkce formuláře událost zpracuje (nebo si přeje, aby ji PalmOS dále nezpracovával) tak vrátí nenulovou hodnotu (true). Pokud funkce formuláře událost nezpracuje (vrátí hodnotu 0, false), tak se událost pokusí zpracovat operační systém PalmOS standardním způsobem.

Otevření a zavření formuláře

V každém formuláři, pro který definujeme naši vlastní funkci formuláře, musíme reagovat na událost frmOpenEvent. Při zpracování této události musíme vykreslit formulář na obrazovce (voláním funkce FrmDrawForm()) a chceme-li, tak můžeme do formuláře něco přikreslit, nastavit počáteční hodnoty přepínačů, zaškrtávacích a textových políček apod. ve formuláři.

Na obdobnou událost frmCloseEvent (uzavření formuláře) reagovat nemusíme. Pokud je funkci pro zpracování událostí formuláře předána zpráva o události frmCloseEvent a tato funkce vrátí nulovou hodnotu (false), tak je událost frmCloseEvent zpracována operačním systémem - formulář je vymazán z obrazovky a jsou zrušena jeho data.

Definice funkce pro zpracování událostí formuláře

Prototyp funkce pro zpracování událostí ve formuláři je následující:

Boolean FormEventHandlerType(EventType *event)

Ve struktuře event je v položce event->eType uložen typ zprávy (nebo chceme-li typ události). Jednotlivé konstanty pro typy událostí si můžete prohlédnout v tabulce, která byla uvedena výše v této kapitole. Příklad obsahu funkce pro zpracování událostí formuláře je ukázán v rámečku. Tato funkce reaguje na událost frmOpenEvent (povinné vykreslení formuláře) a kromě toho i na událost penDownEvent (dotek pera na displeji).

Boolean ZpracovaniUdalostiFormulare(EventType* event)
{
  Boolean zpracovano;

  switch(event->eType)
  {
    case frmOpenEvent:
        
		// zpracovani udalosti otevreni formulare: vykresleni 
		// aktivniho formulare na displeji
		
        FrmDrawForm(FrmGetActiveForm());
        
		// tady můžeme do formuláře něco nakreslit

        zpracovano = true;
        break;

    case penDownEvent:
	
		 // Zde je umístěno například zpracování 
		 // události doteku pera na displeji. Protože
		 // tuto událost zpracováváme, vrátíme hodnotu true
		
		 ...
		
         zpracovano = true;
         break;

    default:

        // pro všechny ostatní události vrátíme hodnotu false,
		// protože nás nezajímají

        zpracovano = false;
        break;
  }

  return zpracovano;
}

2.35 Data přiložená ke zprávám o událostech

Definici datové struktury EventType naleznete v hlavičkovém souboru Core/UI/Event.h. V této datové struktuře jsou mimo typ zprávy (v prvku eType) uložena i související data, která upřesňují podrobnosti o události. Definice této struktury je následující (pro stručnost uvedu jen začátek definice, úplnou definici si prohlédněte v hlavičkovém souboru).

typedef struct EventType {
   eventsEnum     eType;
   Boolean        penDown;
   UInt8          tapCount;
   Int16          screenX;
   Int16          screenY;

   union {
      struct ctlSelect {
         UInt16             controlID;
         struct ControlType *pControl;
         Boolean            on;
         UInt8              reserved1;
         UInt16				value;		
         } ctlSelect;

      struct frmOpen {
         UInt16             formID;
         } frmOpen;

      struct menu {
         UInt16             itemID;
         } menu;
		 
	...
	
      } data;

} EventType;

Tato struktura obsahuje některé prvky, které jsou společné pro všechny zprávy o událostech (například eType: typ události) a prvky, které jsou pro každou zprávu o události specifické (uloženy v prvku data). Jediný z prvků společných pro všechny události, který je vždy vyplněn, je typ události (prvek eType);

K jednotlivým prvkům struktury, které jsou specifické pro jednotlivé zprávy, přistupujeme přes union data, jehož prvky jsou pojmenované podobně jako události (například event.data.ctlSelect.value je hodnota přepínače, která je předávána při zprávě ctlSelectEvent). V dalším popisu zpráv o událostech v této i příštích kapitolách budu uvádět jen ty prvky struktury EventType, které jsou při předávání dané zprávy naší aplikaci vyplněny.

2.36. Události pro nahrání a otevření formuláře

Požadavek na aktivaci formuláře - frmLoadEvent

Tato zpráva je požadavek na aktivování jednoho z našich formulářů. Tuto zprávu obvykle zasílá naše aplikace sama sobě voláním funkce FrmGotoForm() nebo FrmPopupForm(). Ve struktuře EventType je vyplněn následující prvek:

frmLoadEvent
EventType* event;
UInt16 event->data.frmLoad.formID
Číslo prostředku formuláře, který bude aktivován.

Tuto zprávu musíme v naší aplikaci také zpracovat. Správnou reakcí na tuto zprávu je aktivace formuláře, jehož číslo prostředku je v této zprávě předáno:

  1. Voláním funkce FrmInitForm() inicializovat formulář, jehož číslo prostředku bylo uvedeno ve zprávě.
  2. Voláním funkce FrmSetActiveForm() tento formulář aktivovat.
  3. Podle čísla prostředku formuláře sdělit operačnímu systému funkci formuláře, která bude použita pro zpracování událostí právě aktivovaného formuláře (voláním FrmSetEventHandler().)

Fragment zdrojového textu popisující zpracování této zprávy je v následujícím rámečku:

FormPtr formular = FrmInitForm(event->data.frmLoad.formID);

if(formular == NULL)
{
    // Chyba - nesouhlasí čísla prostředků definována v souboru 
    // prostředků aplikace.  
}

FrmLoadForm(formular);

switch(event->data.frmLoad.formID)
{
    case Formular1:
        FrmSetEventHandler(formular, FunkceFormulare1);
        break;

    case Formular2:
        FrmSetEventHandler(formular, FunkceFormulare2);
        break;
...
}

Tato zpráva je jediná, kterou musíme v naší aplikaci zpracovat nezávisle na funkcích formulářů. Pro zpracování této zprávy později definujeme vlastní funkci, kterou nazveme UdalostZpracovanaAplikaci().

Otevření formuláře - frmOpenEvent

Tato událost je zaslána funkci aktivního formuláře jako požadavek na jeho vykreslení na displeji a na nastavení ovládacích prvků formuláře. Při této události je ve struktuře EventType vyplněn následující člen:

frmOpenEvent
UInt16 event->data.frmOpen.formID
Číslo prostředku formuláře, který bude vykreslen na displeji.

Naše funkce formuláře může zjistit ukazatel na strukturu FormType s daty příslušného formuláře voláním funkce FrmGetActiveForm() a je zodpovědná za vykreslení formuláře na obrazovce (funkcí FrmDrawForm()).

...
    case frmOpenEvent:
        formular = FrmGetActiveForm();
        FrmDrawForm(formular);
        return true;
....

Tuto zprávu musíme v každé funkci formuláře zpracovat: inicializovat přepínače a další prvky formuláře a vykreslit formulář na displeji. Poté můžeme dokreslit do formuláře vlastní grafické prvky a nakonec musí funkce formuláře vrátit hodnotu true jako příznak úspěšného zpracování této zprávy.


Příště si uvedeme seznam událostí, které jsou spojeny s dotekem a pohybem pera po displeji.




Nejčtenější

Nový „levný“ iPhone má být hit. Prodat se ho má 100 milionů

Trojice iPhonů pro rok 2018

Apple chystá na letošní rok tři nové iPhony. Jedním z nich má být levnější model, který nebude mít OLED displej. A...

Vodafone extrémně vylepšuje rodinné tarify. Zadarmo přidává 8 GB a VDSL

Vodafone (ilustrační fotografie)

Není obvyklé, aby operátor výrazně vylepšil tarif a nesáhl na cenu. V případě inovovaných rodinných tarifů Red+ tomu...



Teď přijde řada na naše peníze. V Číně totiž končí zlaté časy

Xiaomi Mi 6

Čínský trh s chytrými telefony je největší na světě, ale loni se podle všeho dostal do potíží. Po letech růstu přišel...

Lidé si stěžovali na špatný signál. Rušil ho těžař bitcoinů

(Ilustrační snímek)

Newyorští zákazníci amerického operátora T-Mobile si stěžovali na znatelný šum během telefonních hovorů. Ukázalo se, že...

Krásné mechanické chytré hodinky jsou i v menší variantě. Ale ta cena

Značka TAG Heuer představila zmenšenou variantu svých chytrých modulárních...

Švýcarská hodinářská značka TAG Heuer představila zmenšenou variantu chytrých hodinek Connected. Zatímco jejich první...

Další z rubriky

Šetří místo i data. Dietní Messenger od Facebooku je i v Česku

Aplikace Facebook Messenger Lite je dostupná i v Česku

Facebook Messenger je jedním z nejpoužívanějších kecálků, ale ne všechny telefony si s ním poradí. Loni se tak zrodila...

S těmito aplikacemi se o dovolené neztratíte. Najdou let i levný hotel

Ilustrační snímek

Místo slovníku, mapy a průvodce už řada lidí vyráží na dovolenou na neznámé místo jen se svým telefonem. V mnoha...

Bez reklamy ani ránu. Bude už i na Facebook Messengeru v mobilu

Mobilní Messenger projde změnou, k nelibosti uživatelů v něm budou cílené...

Oblíbený mobilní kecálek se brzy promění. Facebook totiž do Messengeru po úspěšném testování implementuje cílené...

The Baby Gang: Když se vám narodí dvojčata
The Baby Gang: Když se vám narodí dvojčata

Představte si, že jste mladý pár, rozhodnete se pro miminko a narodí se vám dcerka. Po chvíli se shodnete, že by malá měla mít sourozence, ale namísto jednoho jí dopřejete hned tři. A všechny tři naráz

Najdete na iDNES.cz