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.

30. 12. 2007

Logá pre Vaše aplikácie

Spoločnosť CodeGear uvoľnila logá "built with" a "powered by", ktoré môžete použiť vo Vašich aplikáciach alebo webových stránkach vyvinutých pomocou produktov CodeGear.
Logá nájdete na stránkach spoločnosti CodeGear.

UserGuide - kapitola 3.1.4

3.1.4 Pridávanie komponentov do existujúceho balíka

Každý balík môže obsahovať viacej komponentov, ktoré môžu byť nainštalované v palete nástrojov. Jednoducho pridajte tie, ktoré sú potrebné, bez vytvárania nového balíkového súboru a potom ich registrujte v balíkovom súbore.

Pridanie užívateľských komponentov do existujúceho balíka

  1. Zvoľte Component - New Component a použite dialógový box New Component na vytvorenie každého doplnkového komponentu pre Váš balík. Odznačte Create Package v dialógovom okne ak už balík existuje.
  2. Uložte každý nový komponent do toho istého podadresára v adresári vcl ako balík do ktorého má komponent patriť.
  3. Otvorte balíkový súbor name.package.php
  4. Pridajte metódu registerComponents() pre každý komponent ktorý chcete aby sa zobrazil na palete nástrojov.

    Napr.:

    //Change yourunit.inc.php to the php file which contains the component code

    registerComponents("Samples",array("MyLabel"),"MyCustomComponents/MyLabel.inc.php");

    registerComponents("Samples",array("MyButton"),"MyCustomComponents/MyButton.inc.php");

    registerComponents("Samples",array("MyCheckBox"),"MyCustomComponents/MyCheckBox.inc.php");

  5. Nainštalujte balík do IDE
Užívateľská príručka v anglickom jazyku.

19. 12. 2007

UserGuide - kapitola 3.1.3

3.1.3 Pridávanie obrázkovej ikony komponentu

Môžete pridať ikonu užívateľskej komponenty, ktorá ju bude reprezentovať v IDE, keď nainštalujete komponent do palety nástrojov.

Pridanie obrázka

  1. Vytvorte ikonu pre Váš komponent a uložte ju ako bitmapový obrázok s takým istým názvom, ako je názov komponentu.
  2. Vytvorte podadresár icons v adresári Vášho projektu pod adresárom vcl.
  3. Nakopírujte obrázok ikony do podadresára icons.
  4. Otvorte balík so súbormi pre komponent v Code Editore
  5. Modifikujte cestu v setIconPath() tak, aby ukazovala na podadresár icons pre projekt.
Užívateľská príručka v anglickom jazyku.

18. 12. 2007

UserGuide - kapitola 3, 3.1, 3.1.1, 3.1.2

3 Procedúry

Táto kapitola obsahuje procedúry pre Delphi for PHP.

3.1 Všeobecne

Táto kapitola obsahuje všeobecné procedúry (general procedures) pre Delphi for PHP

3.1.1 Pristupovanie k Designeru

Pristúpenie k Designeru

  1. Otvorte Váš projekt v Delphi for PHP.
  2. Zvoľte File - New Form z hlavného menu. Designer zobrazí formulár v strede panela IDE.

3.1.2 Pridanie komponentov do formulára

Pridanie komponentu do formulára

  1. Vytvorte alebo otvorte formulár v Delphi for PHP.
  2. Kliknite na ikonu plus pri kategórii nástrojov na palete nástrojov na zobrazenie zoznamu inštalovaných komponentov.
  3. Dvakrát kliknite na komponent ktorý chcete pridať do formulára alebo naň kliknite a preneste ho do formulára pomocou myši. Vizuálna reprezentácia komponentu sa zobrazí na formulári.
Keď je komponent na formulári, môžete použiť Object Inspector na rýchle nastavenie jeho vlastností a vytvoriť udalosti.
Užívateľská príručka v anglickom jazyku.

12. 12. 2007

UsegGuide - kapitola 2.6

2.6 IBX for PHP – prehľad

IBX for PHP je súbor dátových komponentov, ktoré poskytujú prostriedky prístupu k dátam z databázy Interbase. Komponenty IBX for PHP sú umiestnené v palete nástrojov, v záložke InterBase.

IBDatabase

Na vytvorenie spojenia s databázou použite komponent IBDatabase, ktorý môže zahrnúť jednu alebo viacej súbežných transakcií. IBX for PHP má komponent separátnej transakcie, ktorý dovoľuje separovať transakcie a databázové spojenia.

Nastavenie databázového spojenia:

  1. Vložte komponent IBDatabase do formulára alebo dátového modulu.
  2. Vyplňte vlastnosť DatabaseName. Pre lokálne spojenie to je jednotka, cesta a názov databázového súboru. Vlastnosť Connected nastavte na true.
  3. Do vlastnosti Username vložte užívateľské meno a do vlastnosti Password vložte heslo.

IBTable

Na nastavenie nakonfigurovaného datasetu alebo na prehliadanie bez potreby vloženia SQL príkazu použite komponent IBTable. Komponenty IBTable sa konfigurujú veľmi ľahko:

  1. Pridajte komponent IBTable do Vášho formuláru alebo dátového modulu.
  2. Špecifikujte asociované databázové komponenty.
  3. Špecifikujte názov relácie zo zoznamu TableName.
  4. Vlastnosť Active nastavte na true.

IBQuery

Na vykonanie InterBase DSQL príkazu použite komponent IBQuery. Obmedzte Váš výsledok nastavením len partikulárnych stĺpcov a riadkov, použite agregátne funkcie a spojte viacnásobné tabuľky.

Komponenty IBQuery poskytujú dataset určený len na čítanie a veľmi dobre sa prispôsobujú prostrediu klient/server.

Nastavenie komponentu IBQuery:

  1. Nastavte spojenie pomocou komponentu IBDatabase tak ako bolo popísané.
  2. Pridajte komponent do IBQuery do Vášho formulára alebo dátového modulu.
  3. Špecifikujte asociované databázy a transakčné komponenty.
  4. Vložte SQL príkaz do vlastnosti SQL komponenty IBQuery v stringovom editore.
  5. Vlastnosť Active nastavte na true.

IBStoredProc

Pre vykonateľné procedúry InterBase použite komponent IBStoredProc. Vykonateľné procedúry sú procedúry, ktoré vratia vo väčšine jeden riadok informácie. Pre uložené procedúry, ktoré vrátia viac než jeden riadok dát alebo „Select“ procedúry použite IBQuery.

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

5. 12. 2007

Preklad príkladu - Button

Tento príklad zobrazuje rozličné použitia komponentu Button ako napr. použitie JavaScriptu, image buttonu, hintu atď...

Príklad tiež zobrazuje ako presmerovať viaceré udalosti do toho istého ovládača udalosti (handler) a spracovanie rozličných akcií závislých na parametri $sender.

3. 12. 2007

UserGuide - kapitola 2.5

2.5 VCL for PHP - prehľad

Táto kapitola pojednáva o:

  • architektúre VCL for PHP
  • komponentoch VCL for PHP
  • práci s týmito komponentami

Architektúra VCL for PHP

VCL je skratkou pre Visual Component Library (Knižnica vizuálnych komponentov). VCL je súbor vizuálnych komponentov pre rýchly vývoj PHP aplikácií. VCL for PHP obsahuje rôznorodé vizuálne a nevizuálne komponenty a utility rozdelené podľa úloh (budovanie aplikácie, webové aplikácie, databázové aplikácie, konzolové aplikácie). Všetky triedy pochádzajú z objektu (Object). Objekt predstavuje metódy, ktoré implementujú základné správanie ako napr. konštrukciu, deštrukciu a obsluhu správ.

Komponenty VCL for PHP

Komponenty VCL for PHP sú podmnožinou knižnice komponentov, ktorá vychádza z triedy Component. Komponenty môžete vložiť do formulára alebo dátového modulu a v čase návrhu s nimi môžete manipulovať. Použitím Object Inspectora môžete priradiť hodnoty vlastností bez písania kódu. Veľa komponentov sú vizuálne alebo nevizuálne. Závisí to na tom, či sú viditeľné v čase spustenia. Veľa komponentov je umiestnených v palete nástrojov (Tool Palette).

Vizuálne komponenty

Vizuálne komponenty ako napr. Form a Button sa nazývajú riadiace a vychádzajú z Control. Riadiace komponenty sú použité v GUI aplikáciach a užívateľovi sa objavujú v čase spustenia. Control poskytuje vlastnosti, ktoré špecifikujú vizuálne atribúty prvkov, ako napr. ich výšku a šírku.

Nevizuálne komponenty

Nevizuálne komponenty sa používajú pre rôznorodé úlohy. Napr. ak píšete aplikáciu, ktorá sa pripája do databázy, na spojenie musíte umiestniť do formulára komponent DataSource. Toto spojenie nie je pre užívateľa viditeľné, takže DataSource je nevizuálny komponent. V čase návrhu sú nevizuálne komponenty reprezentované ikonou. To dovoľuje meniť ich vlastnosti a udalosti ako kebyže sú vizuálne.

Iné triedy VCL for PHP

Triedy, ktoré nie sú komponenty (t.j. vychádzajú z Object, ale nie z Component) sú tiež používané pre rôznorodé úlohy. Typicky sa tieto triedy používajú pre prístup systémových objektov (napr. súbor) alebo pre transakčné úlohy (napr. ukladanie dát v zozname). Nemôžete vytvoriť inštancie týchto tried v čase návrhu, pretože sú niekedy vytvorené komponentom, ktorý ste pridali do Form Designera.

Práca s komponentami

Veľa komponentov je dostupných v IDE na palete nástrojov (Tool Palette). Označte komponent z tejto palety a umiestnite ho na formulár alebo dátový modul. Navrhnite užívateľské rozhranie aplikácie usporiadaním vizuálnych komponentov (tlačítka, list boxy) na formulári. Tiež môžete vložiť nevizuálne komponenty (napr. komponenty na prístup do databázy) buď na formulár alebo dátový modul. V prvom rade, komponenty Delphi for PHP sa podobajú na iné triedy. Ale medzi komponentmi v Delphi for PHP a štandardnou triedou hierarchií, s ktorou pracuje veľa programátorov, sú rozdiely. Niektoré rozdiely sú:

  • Všetky komponenty Delphi for PHP vychádzajú z Component.
  • Komponenty sú používané najčastejšie . Sú menené pomocou ich vlastností, skôr než sa pridá alebo zmení ich funkcionalita. Dedičnosť komponentu je obvykle používaná na pridanie špecifického kódu do existujúcich udalostí obslužných funkcií.
  • Vlastnosti komponentov obsahujú runtime informácie.
  • Komponenty môžu byť pridané do palety nástrojov v IDE a môže byť s nimi manipulované na formulári.

Používanie udalostí

Skoro každý skript, ktorý napíšete je vykonaný priamo alebo nepriamo v odpovedi na udalosti. Udalosť je špeciálny druh vlastnosti, ktorá reprezentuje runtime výskyt. Kód, ktorý odpovedá priamo do udalosti sa nazýva ovládač udalosti (handler) a je to procedúra Delphi for PHP.
Stránka Events v Object Inspectore zobrazuje všetky udalosti definované pre určený komponent. Dvojklikom na udalosť v Object Inspectore sa generuje kostra obslužnej procedúry udalosti, ktorú môžete doplniť kódom, ktorý ma byť odpoveďou na túto udalosť. Nie všetky komponenty majú definované udalosti.

Niektoré komponenty majú východziu udalosť, ktorá je najvšeobecnejšou udalosťou potrebnou na ovládanie. Napr. východzia udalosť pre tlačítko je OnClick. Dvojklikom na komponent s východzou hodnotou vo Form Designeri bude vygenerovaná kostra obslužnej procedúry udalosti pre východziu udalosť.
Kód môžete opätovne použiť prepísaním ovládačov udalosti, ktorý zodpovedá viac než jednej udalosti. Napr. veľa aplikácií poskytuje tlačítka, ktoré sú ekvivalentom príkazov roletového menu. Keď tlačítko vykoná tú istú akciu ako príkazy menu, môžete napísať jednoduchý ovládač udalosti a potom ho súčasne priradiť k udalosti
OnClick pre tlačítko a položku menu nastavením ovládača udalosti v Object Inspectore pre obe udalosti, na ktoré chcete odpovedať. Môžete tiež vytvoriť podobný ovládač udalosti pre JavaScript udalosť. Toto je najjednoduchší spôsob opätovného použitia ovládačov udalosti. Avšak zoznamy akcií poskytujú silné nástroje pre centrálne organizovanie kódu, ktorý odpovedá na príkazy užívateľa.

Nastavenie vlastností komponentov

Na nastavenie uverejnených vlastností v čase návrhu môžete použiť Object Inspector a v niektorých prípadov editor vlastnosti. Na nastavenie vlastností v čase behu programu (runtime), priraďte ich hodnoty vo Vašom zdrojovom kóde.
Keď vyberiete komponent na formulár v čase návrhu, Object Inspector zobrazí jeho uverejnené vlastnosti a keď zodpovedajú, dovolí Vám ich editovať.
Keď je označených viac ako jeden komponent, Object Inspector zobrazí všetky vlastnosti (okrem
Name), ktoré sú spoločné pre všetky komponenty. Ak hodnota pre spoločnú vlastnosť medzi vybranými komponentmi je rozdielna, Object Inspector zobrazí buď prednastavené hodnoty alebo hodnotu z prvého vybraného komponentu. Keď meníte spoločnú vlastnosť, zmena sa uplatní na všetky označené komponenty. Pri zmene vlastností, ktoré sú viazané s kódom (code-related), ako napr. meno ovládača udalosti, Object inspetor automaticky zmení zodpovedajúci zdrojový kód.

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

30. 11. 2007

Preklad príkladu - Blog Example for Delphi for PHP

Autor: Jonathan Benedicto

Inštalácia

Tento príklad blogu ja založený na MySQL databáze a obsahuje 3 tabuľky. Štruktúra databázy môže byť vytvorená použitím súboru blog_tables.sql.
Informácie o pripojení k databáze sú uložené v súbore configure.php. Prispôsobte tento súbor na Vaše nastavenie.

Administrácia
Prednastavené užívateľské meno a heslo pre administráciu je test/test. Aktuálne hodnoty sú uložené v tabuľke admins.

Spustenie
Otvorte index.php a stlačte tlačítko Run

28. 11. 2007

UserGuide - kapitola 2.4

2.4 Nasadenie PHP aplikácií – prehľad

Potom, ako napíšete, otestuje a vyladíte Vašu aplikáciu, môžete ju sprístupniť pomocou jej nasadenia.

Redistribúcia súborov Delphi for PHP

Veľa súborov asociovaných s aplikáciami Delphi for PHP sú subjekty s obmedzenou redistribúciou alebo nemôžu byť redistribuované vôbec. Nasledovné dokumenty poukazujú na legálnosť týkajúcu sa redistribúcie týchto súborov.

  • deploy.htm – obsahuje uváženie nasadenia pre Delphi for PHP.
  • license.txt – adresuje legalitu a povinnosti ohľadne Delphi for PHP.
  • readme.htm – obsahuje last minute informácie o Delphi for PHP, možné informácie, ktoré by mohli mať vplyv na redistribúciu práv pre súbory Delphi for PHP files.

Tieto súbory sú umiestnené v adresári kde je nainštalované Delphi for PHP alebo v hlavnom adresári na CD.

Redistribúcia softvéru tretích strán

Redistribučné práva pre softvér tretích strán (komponenty, utility a help aplikácie), sa riadia výrobcom, ktorý tento softvér poskytuje. Predtým ako budete redistribuovať softvér tretích strán spolu s Vašou aplikáciou vytvorenou v Delphi for PHP, konzultujte to s výrobcom alebo softvérovou dokumentáciou.

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

26. 11. 2007

Preklad príkladu - Basic Authentification

Tento príklad charakterizuje komponent BasicAuthentification, ktorý dovoľuje pohodlne použiť HTTP autentifikáciu bez vytvárania súborov na serveri. Autentifikácia prebieha iba posielaním potrebných hlavičiek browseru.
Pre použite komponentu ho stačí vložiť do formulára a zavolať exekučnú metódu na udalosť OnBeforeShow stránky. Toto prinúti komponet zobraziť autentifikačné okno v prípade, že užívateľ nebol ešte validovaný.
Musíte zadať vlastnosti komponentu (UserName a Password), na špecifikáciu, ktorej kombinácia bude validná alebo môžete použiť udalosť OnAuthenticate na vykonanie komplikovanejšej autentifikácie ako napr. hľadanie v databáze.
Na rozoznanie, ktoré meno a heslo bolo zadané užívateľom, skontrolujte parameter udalosti $params.

UserGuide - kapitola 2.3

2.3 Ladenie – prehľad

Debugger Vám umožňuje nájsť a odstrániť chyby vzniknuté počas behu aplikácie a logické chyby. Použitím debuggera môžete krokovať kód, nastavovať body prerušenia (breakpoints) chodu aplikácie, sledovať, kontrolovať a modifikovať programové premenné. Ak ladíte Vašu aplikáciu, ladiace okná Vám pomôžu manažovať celé ladenie a poskytujú informácie o stave Vašej aplikácie.

Krokovanie kódu

Krokovanie kódu umožňuje spustiť Váš program riadok po riadku. Po každom kroku môžete kontrolovať stav programu, prezerať programové výstupy, modifikovať premenné a pokračovať s vykonávaním kódu na ďalšom riadku. Ďalší riadok kódu nebude vykonaný, pokiaľ neumožníte debuggeru pokračovať.
Menu Run poskytuje príkazy Trace Into a Step Over. Oba príkazy hovoria debuggeru aby pokračoval na nasledujúcom riadku kódu. Ak riadok obsahuje volanie funkcie, Trace into vykoná funkcie a zastaví sa na prvom riadku kódu vo funkcii. Step over vykoná funkciu a až potom sa zastaví na prvom riadku po ukončení funkcie.
2

Breakpoints

Body prerušenia pozastavia vykonávanie programu v určitom bode programu alebo keď sa objaví partikulárna podmienka. Potom môžete použiť debugger napr. na prezeranie stavu Vášho programu.
Debugger podporuje zdrojové body prerušenia, ktoré pozastavia vykonávanie v špecifickom mieste vo Vašom zdrojovom kóde.

Watches

Watches dovoľujú sledovať hodnoty premenných alebo ich výrazy keď krokujete vo Vašom programe. Hodnota sledovaného výrazu sa mení, keď Váš program updatuje ľubovoľnú premennú obsiahnutú v sledovanom výraze.

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

22. 11. 2007

UserGuide - kapitola 2.2

2.2 Editovanie kódu – prehľad

Code Editor je prispôsobiteľný editor, ktorý poskytuje zvýrazňovanie syntaxe a možnosť mnohonásobných spätných krokov (undo). Keď navrhujete užívateľské rozhranie pre Vašu aplikáciu, Delphi for PHP vygeneruje kód. Keď modifikujete vlastnosti objektu, Vaše zmeny sa automaticky odzrkadlia v zdrojovom súbore.
Pretože všetky Vaše programy zdieľajú všeobecné charakteristiky, Delphi for PHP vygeneruje kód hneď po spustení. Vygenerovanie kódu si môžete predstaviť ako šablónu, ktorú môžete overovať a modifikovať za účelom vytvorenia Vášho programu.
Code Editor poskytuje nasledovné možnosti ako Vám pomôcť pri písaní

  • Code Insight
  • Bookmarks

Code Insight

Code Insight poukazuje na podmnožinu vlastností vstavaných v Code Editore, ktorá pomáha pri procese písania kódu. Tieto vlastnosti pomáhajú identifikovať všeobecné vyjadrenia (statements), ktoré si želáte vložiť do Vášho kódu a napomáhajú pri výbere vlastností a metód. Niektoré z týchto vlastností sú detailnejšie popísané v ďalších podkapitolách.

Bookmarks

Bookmarky poskytujú pohodlný spôsob navigácie v dlhých súboroch. Miesto vo Vašom kóde môžete označiť bookmarkom a skočiť do tohto miesta z iného miesta v súbore. Môžete použiť až 10 záložiek, označených od 0 po 9 v jednom súbore. Keď nastavíte bookmarku, v ľavom rohu Code Editora sa zobrazí ikona knihy.

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

19. 11. 2007

UserGuide - kapitola 2 a 2.1

2 Koncepty
Táto kapitola obsahuje konceptuálne informácie pre Delphi for PHP.

2.1 Rozhranie pre užívateľský návrh – prehľad

Grafické vizuálne rozhranie (GUI) pozostáva z jedného alebo viacerých okien, ktoré umožňujú užívateľovi interakciu s jeho aplikáciou. V čase návrhu sú tieto okná nazývajú formuláre. Designer a formuláre Vám pomáhajú rýchlo a ľahko vytvoriť profesionálne vyzerajúce užívateľské rozhranie.

Designer

Keď vytvárate aplikáciu, IDE automaticky zobrazí vhodný typ formuláre. Keď umiestnite komponenty (návestia alebo textové polia) do formulára z palety nástrojov, Delphi for PHP vygeneruje kód do aplikácie. Použitím Object Inspectora môžete modifikovať vlastnosti komponentov a formulára. Výsledky týchto zmien sa zobrazia automaticky v zdrojovom kóde v záložke Code. Naopak, keď modifikujete kód v Code Editore, zmeny, ktoré vykonáte sú okamžite odzrkadlené v záložke Design.

Paleta nástrojov poskytuje možnosti na zjednodušenie vytvárania formulárov. Keď vytvárate menu podobné Windowsu, môžete napr. použiť komponent MainMenu na vytvorenie prispôsobiteľného hlavného menu za minútu. Po vložení komponentu do formulára vyplňte položky a príkazy hlavného menu poskytnuté v boxe.

Formuláre

Formuláre sú základom všetkých aplikácií vyvinutých použitím Delphi for PHP. Užívateľské rozhranie pre Vašu aplikáciu navrhujete použitím formulárov. Formuláre môžu obsahovať menu, tlačítka, editovacie políčka, dialógové boxy alebo iné objekty, ktoré potrebujete na to, aby aplikácia pracovala tak, ako chcete Vy.

Vašu aplikáciu vyvíjate prispôsobením hlavného formulára (main form) a pridávaním prispôsobiteľných formulárov pre iné časti rozhrania. Formuláre prispôsobujete pridávaním komponentov a nastavovaním vlastností.

Tieto a mnoho iných vlastností môžete meniť použitím Object Inspectora.

Návrh užívateľského rozhrania pre HTML prehliadače

Navrhovanie užívateľského rozhrania PHP aplikácie, ktorá sa zobrazuje v HTML prehliadači, má viaceré obmedzenia, ktoré štandardné aplikačné rozhranie nemá. Napr. v HTML nemôžete prekrývať jeden prvok iným, pokiaľ chcete, aby sa Vaša aplikácia zobrazila správne vo všetkých prehliadačoch.

Keď rozvrhujete vaše užívateľské rozhranie a dva alebo viaceré komponenty sa prekrývajú, v ľavom hornom rohu každého komponentu sa zobrazí ikona žltého výkričníka. Ak sa to stane, pri spúšťaní skriptu sa nevypíšu žiadne chyby. Napriek tomu, vizuálne výsledky sú neočakávané a najpravdepodobnejšie sa jeden komponent nezobrazí. Preto najlepším pravidlom pri návrhu užívateľského rozhrania pre HTML prehliadače je, nespúšťať stránky, na ktorých je zobrazená ikona žltého výkričníka v Designeri. Prepracujte jednotlivé vrstvy tak, aby sa neprekrývali.

Vlastnosti Designera

Designer môžete konfigurovať nastavením vlastností, ktoré ovplyvňujú vzhľad a správanie Designera. Môžete napr. upraviť nastavenia mriežky alebo zobraziť titulky komponentu. Vlastnosti Designera sú v menu Page Designer, ktoré je umiestnené v Environmental Option v dialógovom menu Options.

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

16. 11. 2007

Preklad príkladu Ajax - Database

Tento príklad ukazuje, ako použiť Ajax na prácu s databázou. Používa Ajax na poslanie tabuľky na server, ktorú chce užívateľ prehliadať a zmenu vlastností tabuľky za účelom otvorenia tej správnej.
Používa sa tu javascriptová udalosť OnChange ListBox-u na vykonanie volania Ajaxu:

params=document.AjaxDatabase.ListBox1.options[document.AjaxDatabase.ListBox1.value].text;


Nastaví paramentre do mena tauľky na ktorú užívateľ klikol a budú poslané na server. Potom:

echo $this->ListBox1->ajaxCall("changeTable",array(),array("ddaddress_book1"));


Tento dump Ajax javascriptového kódu vykoná volanie do metódy changeTable, ktorá tiež obdrží inštrukcie na update len DBGrid-u. Zvyšné riadiace prvky nebudú updatnuté. Je to výhodné pre zníženie trafiku na návrat Ajaxu.

15. 11. 2007

UserGuide - kapitola 1.2

1.2 Prehliadka IDE Delphi for PHP

Keď otvoríte Delphi for PHP, IDE spustí a zobrazí viacero nástrojov a menu. IDE Vám pomáha vizuálne navrhnúť Vaše rozhranie, nastaviť vlastnosti objektov, písať kód, prezerať a manažovať Vašu aplikáciu rozličnými spôsobmi.
Prednastavený vzhľad IDE obsahuje niekoľko najobvyklejších používateľských nástrojov. Na zobrazenie alebo skrytie určitých nástrojov môžete použiť menu View. Vzhľad, ktorý je pre Vás najlepší si môžete prispôsobiť a uložiť.
Nástroje dostupné v IDE obsahujú:

  • Start Page
  • Forms
  • Form Designer
  • Tool Palette
  • Object Inspector
  • Project Manager
  • Data Explorer
  • Structure View
  • Code Editor

Nasledovné časti popisujú každý z týchto nástrojov.

Start Page
Keď otvoríte Delphi for PHP, Start page sa zobrazí s odkazmi vyvíjaných zdrojov, napr. súvisiacimi článkami, školeniami a online pomocou. Pri vývoji projektu k nim môžete rýchlo pristupovať zo zoznamu posledných projektov na vrchnej časti stránky.

Forms
Je typické, že formulár reprezentuje okno alebo HTML stránku v užívateľskom rozhraní. V čase dizajnu je formulár zobrazený na vrchnej časti Designer-a. Na vytvorenie Vášho užívateľského rozhrania môžete použiť komponenty z Palety náradia (Tool Palette)

Form Designer
Form Designer alebo Designer je zobrazený automaticky, keď používate formuláre.

Visual Components
Vizuálne komponenty sa objavujú na formulári v čase návrhu a sú viditeľné pre koncového užívateľa v dobe behu aplikácie. Obsahujú také prvky ako napr. tlačítka, návestia, toolbary a listboxy.

Nonvisual Components a Component Tray
Nevizuálne komponenty sa zobrazujú vo formulári, ale sú viditeľné iba v čase návrhu. Nie sú viditeľné pre koncového užívateľa v dobe behu aplikácie. Nevizuálne komponenty môžete použiť ako spôsob opätovného použitia skupín databázy a systémových objektov alebo na izolovanie častí Vašej aplikácie, ktorá spravuje databázové spojenie a prevádzkové práva.
Keď pridáte nevizuálny komponent do formulára, zobrazí sa ako malá ikona. Túto ikonu môžete označiť a nastaviť vlastnosti komponentu.

Tool Palette
Paleta nástrojov obsahuje vizuálne a nevizuálne komponenty, ktoré sa používajú pri vývoji aplikácie. Do formulára ich pridávate dvojklikom. Ak prezeráte zdrojový kód v Code Editore, paleta nástrojov zobrazuje časti kódu, ktoré môžete pridať do Vašej aplikácie.

Customized Componenets
Ku komponentom, ktoré sú nainštalované s Delphi for PHP môžete pridávať prispôsobiteľné komponenty alebo komponenty tretej strany a ukladať ich do vlastných kategórií.

Object Inspector
Object Inspector dovoľuje nastaviť vlastnosti a vytvoriť ovládanie udalostí pre komponenty. Toto poskytuje spojenie medzi Vašim aplikačným vizuálnym vzhľadom a kódom. Object Inspector obsahuje tri tabuľky:
Properties, Events a JavaScript Events.
Tabuľka Properties sa používa na zmenu fyzických atribútov komponentov. V závislosti na výbere, niektorá kategória nastaví zadané hodnoty v textovom poli, zatiaľ čo iné požadujú výber hodnôt z roletového menu (drop-down box). Pre boolovské hodnoty môžete voliť True alebo False. Po zmene fyzických atribútov komponentu môžete vytvoriť ovládanie udalosti, ktorá riadi ako komponent funguje.
Tabuľka Events špecifikuje udalosti označeného objektu. Ak existuje ovládanie udalostí, použite na jeho výber roletové menu.
Tabuľka JavaScript Events špecifikuje udalosti JavaScriptu pre označený objekt. Ak existuje ovládanie udalostí, použite na jeho výber roletové menu.

Project Manager
Projektový manažér vytvára viacero aplikačných súborov. Projektový manažér Vám umožňuje prezeranie a organizovanie Vašich projektových súborov. Pomocou projektového manažéra môžete pridávať alebo mazať súbory. Tiež môžete kombinovať príbuzné projekty do projektových skupín.

Data Explorer
Data Explorer umožňuje prehliadať databázové tabuľky a polia. Použitím kontextového menu môžete vytvoriť a manažovať databázové pripojenia. Tiež môžete využiť metódu „drag and drop“ na rýchle budovanie databázy.

Code Editor
Code Editor poskytuje pohodlnú cestu ako prezerať a modifikovať Váš zdrojový kód. Je to prispôsobiteľný editor, ktorý poskytuje zvýrazňovanie syntaxe, spätné kroky (undo), atď.

Code Explorer
Pomocou Code Exploreru môžete vidieť funkcie, konštanty, premenné použité vo Vašom kóde.

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

14. 11. 2007

UserGuide - kapitola 1 a 1.1

1 Úvod
Integrované vývojové prostredie (IDE) Delphi for PHP poskytuje mnoho nástrojov a možností ako Vám pomôcť pri rýchlom vytváraní výkonných aplikácií.

1.1 Čo je Delphi for PHP?

Delphi for PHP je integrované vývojové prostredie (IDE) pre vytváranie PHP aplikácií. IDE Delphi poskytuje súbor nástrojov, ktoré zefektívňujú a zjednodušujú životný cyklus vývoja aplikácie. Nesledujúce časti v krátkosti popisujú tieto nástroje.

Návrh užívateľského rozhrania
Vizuálny dizajnér Delphi for PHP Vám dovoľuje vytvoriť grafické užívateľské rozhranie pomocou drag and drop komponentov z palety nástrojov (Tool Palette). Použitím dizajnéra môžete vytvoriť formuláre.

Generovanie a editácia kódu
Delphi for PHP generuje viacero kódov Vašej aplikácie, len čo začnete vytvárať projekt. Textový Code Editor Vám pomôže pri kompletizácii zostávajúcej aplikačnej logiky. Code Editor poskytuje možnosti ako kompletizovať kód. Zvýraznenie syntaxe robí Váš kód jednoduchší na čítanie a na navigáciu.

Ladenie aplikácií
Integrovaný debugger Vám umožňuje nájsť a odstrániť logické chyby.

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