28. 1. 2008

UserGuide - kapitola 3.1.7

3.1.7 Vytváranie aplikačného menu

Menu poskytujú jednoduchý spôsob na to, aby užívatelia mohli spúšťať logicky zoskupené príkazy. V čase návrhu môžete položky menu pridať alebo zmazať alebo ich presunúť za účelom zoskupenia. Paleta nástrojov obsahuje komponenty MainMenu a PopupMenu pre vytváranie menu.

Vytváranie menu a položiek menu je v Delphi for PHP iné než v Delphi. Položky menu sú špecifikované v poli namiesto existencie individuálnych komponentov s vlastnosťami. Preto štruktúru menu vytvárajte použitím Items Editora, ktorý je umiestnený v Items Property komponentu MainMenu alebo PopupMenu.

Vytvorenie aplikačného menu

  1. Rozrolujte kategóriu Standard v palete nástrojov a pridajte komponent MainMenu alebo PopupMenu do Vášho formulára. Vizuálna reprezentácia menu sa zobrazí v Designeri. Komponent MainMenu vytvorí menu, ktoré je súčasťou riadku s titulkom príslušného formulára. Komponent PopupMenu vytvorí menu, ktoré sa zobrazí vtedy, keď užívateľ klikne pravým tlačítkom vo formulári.
  2. Kliknite na tlačítko pri Items property pre komponent v Object Inspectore. Toto tlačítko otvorí dialógové okno Items Editor, v ktorom môžete definovať položky menu.
  3. Zadajte textový reťazec pre položku menu do políčka Text (napr. File).
  4. Zadajte jedinečné celočíselné ID do políčka Tag pre položku menu.
  5. Kliknite na tlačítko New Item na pridanie novej položky menu do tej istej úrovne ako označená položka. Na pridanie položky submenu kliknite na tlačítko New SubItem. Táto položka bude pridaná ako dieťa označenej položky. Na vytvorenie separátora medzi jednotlivými položkami umiestnite kurzor do menu tam, kde chcete separátor vložiť a zadajte znamienko spojovník (–) do políčka Text.
  6. Kliknite na tlačítko OK, keď ste skončili s návrhom štruktúry menu.

Na návrh štruktúry menu v Items Editore potrebujete položky pridávať sekvenčne do každej úrovne. Nemôžete vložiť položku menu, ani ju presúvať hore alebo dolu v zozname. Na zmenu vloženej položky alebo zmeny štruktúry, zmažte nutné položky až po požadované miesto.

Zobrazenie obrázka pri položke menu

  1. Pridajte obrázok do adresára s Vašim projektom.
  2. Rozrolujte Advanced category v Palete nástrojov, označte komponent ImageList a preneste ho do formulára.
  3. Vyberte vlastnosť Images v Object Inspectore a kliknite na vedľajšie tlačítko, ktoré otvorí ImageList Editor. Tu môžete vidieť zoznam požadovaných obrázkov a priradiť im identifikátor.
  4. Vložte jedinečný celočíselný identifikátor pre prvý obrázok v stĺpci Key/ID.
  5. Vložte názov obrázku v stĺpci Filename. Tiež môžete kliknúť na tlačítko Load a prehliadať obrázky. Keď vyberiete súbor týmto spôsobom, meno súboru bude vložené do stĺpca Filename. Obrázok sa zobrazí v pravej časti dialógového okna.
  6. Na vytvorenie nového riadku a na pridanie iného obrázka kliknite na tlačítko Add.
  7. Pridajte ostatné obrázky a kliknite na OK.
  8. Znovu označte komponent menu a otvorte Items Editor pre vlastnosť Items.
  9. Vložte korešpondujúce číslo Key/ID obrázku v poli Image Index pre každú položku menu a potom kliknite na OK. Teraz bude pri položke menu zobrazený obrázok.

Vytvorenie ovládača udalosti pre položku menu

  1. Na formulári označte komponent MainMenu alebo PopupMenu.
  2. Vykonajte jednu aktivitu z nasledovných:
    • Dvakrát kliknite na udalosť na záložke Events v Object inspectore, ak vytvárate serverovú udalosť.
    • Dvakrát kliknite na udalosť na záložke Javascript, ak vytvárate klientsku udalosť. Vygeneruje sa kostra kódu pre udalosť v zdrojovom kóde. Napr., ak ste dvakrát klikli na udalosť OnClick, vygenerovaný kód by mohol vyzerať takto:

    function MainMenu1Click($sender, $params)

    {

    }

  3. IDE prepnuté do Code Editora s kurzorom vo vnútri zátvoriek udalosti je pripravené na vytvorenie ovládača udalosti.
  4. Napíšte vetvenie if vo vnútri ovládača udalosti na špecifikovanie toho, ktorá akcia sa má vykonať na každej položke menu.

Keďže položky menu sú polia v komponente MainMenu alebo PopupMenu, nemôžu sa vyskytovať ako individuálne komponenty s vlastnosťami a udalosťami. Preto musíte pre ne špecifikovať udalosti vo vetvení if vo funkcii MainMenu alebo PopupMenu

Napr.

class Unit11 extends Page

{

public $ImageList1 = null;

public $MainMenu1 = null;

function MainMenu1Click($sender, $params)

{

class Unit11 extends Page

{

public $MainMenu1 = null;

function MainMenu1Click($sender, $params)

{

if ($params['tag']==10)

{

//Call here your function

performOpen();

}

if ($params['tag']==20)

{

//Call here your function

performSave();

}

}

}

}

}

Užívateľská príručka v anglickom jazyku.

20. 1. 2008

UserGuide - kapitola 3.1.6

3.1.6 Pridávanie balíkov

Keď vytvárate užívateľské komponenty, spolu s nimi vytvárate balíkový súbor, ktorý registrujete alebo inštalujete s IDE Delphi for PHP. Balíkový súbor je jednoduchý .php súbor, ktorý poskytuje informácie o týchto balíkoch do IDE. Napr. to, ktoré komponenty treba pridať do palety nástrojov, ktoré sú vložené do VCL a špeciálne funkcie pre komunikáciu s IDE.

Keď chcete nainštalovať Vaše komponenty do palety nástrojov, musíte Váš balíkový súbor a komponent uložiť v adresári vcl. Vloženie vašich komponentov do podadresára Vám dovolí budovať Vašu užívateľskú knižnicu bez ovplyvnenia VCL kódu a umožňuje jednoduchší vývoj.

Pridanie balíka do zoznamu inštalovaných balíkov v Delphi for PHP

  1. Zvoľte Component - Packages na otvorenie dialógového okna Installed Packages.
  2. Kliknite na tlačítko Add, potom sa presuňte na balíkový súbor pre Váš komponent a kliknite na tlačítko Open. Na prezeranie zoznamu komponentov v balíku, ktoré sú inštalované do palety nástrojov označte Váš nový balík, potom kliknite na tlačítko Components. Kliknite na OK na návrat do dialógového okna Installed Packages.
  3. Kliknite na OK, aby sa zatvorilo dialógové okno Installed Packages.
Teraz môžete rozvinúť stránku s paletou nástrojov, na ktorej sú nainštalované užívateľské komponenty a mali by ste ich vidieť.

Užívateľská príručka v anglickom jazyku.

11. 1. 2008

Preklad príkladu - ButtonView

Tento príklad charakterizuje komponent ButtonView, ktorý dovoľuje vytvoriť skupinu tlačítok s obrázkom.

Charakterizuje javascriptovú udalosť OnClick a tiež charakterizuje ako môžete kontrolovať na ktoré tlačítko bolo kliknuté (založené na vlastnostiach tagu).

Potom môžete napr. vykonať ajaxCall alebo presmerovať prehliadač na iný skript.

6. 1. 2008

UserGuide - kapitola 3.1.5

3.1.5 Pridávanie a odoberanie súborov

Do Vášho projektu môžete pridávať alebo odoberať rozličné typy súborov.

Pridanie súboru do projektu

  1. Zvoľte Project - Add to Application. Zobrazí sa dialógové okno Add to Project.
  2. Označte súbor, ktorý chcete pridať a kliknite na Open. Súbor sa zobrazí dole pod vláknom Project.exe na Project Manageri.

Odobratie súboru

  1. Zvoľte Project - Remove From Project. Zobrazí sa dialógové okno Remove From Project.
  2. Označte súbor alebo súbory, ktoré chcete odobrať a kliknite na OK.
Užívateľská príručka v anglickom jazyku.