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.