Lazarus Tutorial/sk
This is the start of a Lazarus Tutorial. Please feel free to add your experiences to it.
Overview
Lazarus is a free and open source development tool for the FreePascal Compiler (object pascal), which is also free and open source. The Lazarus IDE (screenshot) is a stable and feature rich programming environment for creating self-standing graphical and console applications. It currently runs on Linux, FreeBSD and Win32 and provides a customizable source editor and visual form creation environment along with a package manager, debugger and complete GUI integration with the FreePascal Compiler.
Getting Started - Your first Lazarus Program!
(Thanks to User:Kirkpatc)
Get, install (Installing Lazarus) and launch Lazarus which will also make available the FreePascal Compiler.
Several windows will appear on the desktop: the main menu at the top, the Object Inspector on the left, the Lazarus Source Editor occupying most of the desktop, and a ready-made Form1 window overlying the Source Editor.
On the top Menu window, underneath the menu line, is a row of tabs. If the 'Standard' tab is not already selected, select it by clicking with the mouse. Then find the Button icon (a rectangle with 'OK' on it) and click on that with the mouse. Then double-click on the Form1 window, somewhere to the left of the middle. A shadowed rectangle labelled 'Button1' will appear. Click again on the Button icon in the Standard tab, and double-click on the Form1 somewhere to the right of centre: a rectangle labelled 'Button2' will appear.
Now click on Button1 to select it. The Object Inspector will display the properties of the object Button1. Near the top is a property named 'Caption', with the displayed value 'Button1'. Click on that box, and change 'Button1' to 'Press'. If you hit ENTER or click in another box, you will see the label of the first button on Form1 change to 'Press'. Now click on the Events tab on the Object Inspector, to see the various events that can be associated with the button. These include OnClick, OnEnter, OnExit etc. Select the box to the right of OnClick: a smaller box with three dots (... ellipsis) appears. When you click on this, you are taken automatically into the Source Editor and your cursor will be placed in a piece of code starting:
procedure TForm1.Button1Click(Sender: TObject);
begin
{now type:} Button1.caption := 'Press again';
{the editor has already completed the procedure with}
end;
Press F12 to select the Form1 window instead of the Source Editor.
Now edit the properties of Button2: click on Button2 to display its properties in the Object Inspector. Change its Caption property to 'Exit' instead of 'Button2'. Now select the Events tab, and click on the box for OnClick. Click on the ... ellipsis, and you will be taken into the Source Editor, in the middle of another procedure:
procedure TForm1.Button2Click(Sender: TObject);
begin
{now type:} Close;
{the editor has already completed the procedure with}
end;
Now Press F12 to see the Form1 window again. You are now ready to try to compile. The simplest way to do this is to select 'Run' from the main menu at the top, and then the 'Run' option on the sub-menu. Alternatively you could simply type F9. This will first compile and then (if all is well) link and execute your program.
Several text windows will appear and all sorts of compiler messages will be typed, but eventually your Form1 window will re-appear, but without the grid of dots; this is the actual main window of your application, and it is waiting for you to push buttons or otherwise interact with it.
Try clicking on the button labelled 'Press'. You will notice that it changes to 'Press again'. If you press it again, it will still say 'Press again'!!
Now click on the button marked 'Exit'. The window will close and the program will exit. The original Form1 window with the grid of dots will reappear, ready to accept more editing activity.
You should save your work now (and frequently!!) by selecting Project > Save As > your_selected_file_name.pas
Second session
.
Re-open your saved Project. On the Form1 window click on the 'Press' button (Button1) to select it. Select the 'Events' tab on the Object Inspector, click on the right side box next to OnClick, click on the ... ellipsis, to go back to the appropriate point in the Source Editor.
Edit your code to read as follows:
procedure TForm1.Button1Click(Sender: TObject);
{Makes use of the Tag property, setting it to either 0 or 1}
begin
if Button1.tag =0 then
begin
Button1.caption := 'Press again';
Button1.tag := 1
end else
begin
Button1.caption := 'Press';
Button1.tag := 0
end
end;
Save your work, re-compile and run. The left button will now toggle between two alternative messages.
The rest is up to you!
If you prefer to write Console- or text-based Pascal programs (for example if you are following a basic Pascal programming course, or you need to write programs to use in batch mode or for system programming), you can still use Lazarus to edit, compile and run your programs. It make an ideal environment for Pascal development. See Console Mode Pascal.
Editor
Pri prvom spustení IDE Lazarus sa na vašej pracovnej ploche objaví niekoľko samostatných, nespojených alebo plávajúcich okien.
Prvé z nich, zobrazené pri hornom okraji pracovnej plochy má titulok Lazarus Editor vXXXXXX - project1. Toto je základné ovládacie okno vášho projektu a obsahuje Základné menu, paletu komponentov a panel nástrojov.
V riadku pod titulkom je Základné menu (Main Menu) so zvyčajnými položkami pre funkcie File, Edit, Search, View atď, spolu s niektorými možnosťami, ktoré sú špecifické pre Lazarus. Nižšie je umiestnený Panel nástrojov s množinou BitButtonov, ktoré sprístupňujú niektoré voľby základného menu a vpravo od neho je Paleta komponentov (Component Palette).
Pod základným oknom IDE Lazarus sa ešte vľavo obajví okno Object Inspector a vedľa neho okno Editora zdrojového kódu (Lazarus Source Editor). Môže sa objaviť ešte jedno menšie okno, nazvané Form1, prekrývajúce Editor zdrojového kódu. Ak nie hneď viditeľné, môžete ho zbraziť stlačením klávesy F12, ktorá prepína medzi zobrazením Editora zdrojového kódu a zobrazením formulára. Okno formulára, je tým, na ktorom budete budovať grafické rozhranie svojej aplikácie, kým okno Editora kódu zobrazuje zdrojový kód Pascalu patriaci aplikácii, ktorú navrhujete. Práca s Object Inspectorom je detailnejšie rozobratá ďalej, pri popise Palety komponentov.
Keď začnete nový projekt (alebo ak prvý krát spustíte Lazarus) je vytvorený štandartný formulár, ktorý obsahuje bodkovanú mriežku, pomáhajúcu umiestniť rôzne komponenty formulára a titulkový pruh, ktorý obsahuje zvyčajné tlačítka pre minimalizovanie, maximalizovanie a zatvorenie okna. Ak kliknete myšou kdekoľvek do formulára, v Object Inspector, na ľavej strane pracovnej plochy, uvidíte vlastnosti formulára.
Počas práce môžu byť zobrazené i ďalšie okná, ako: the Project Inspector, ktorý obsahuje detaily o súboroch, ktoré sú súčasťou projektu a umožňuje prodať alebo odstrániť tieto súbory z/do projektu; alebo okno Messages, ktoré zobrazuje správy prekladača, chyby alebo hlásenia postupu vášho projektu; ak je Lazarus spustený z okna terminálu, pôvodný terminál necháva viditeľné a detailné správy prekladača sú zobrazované i tam.
(Main Menu)
Riadok základného menu obsahuje nasledujúce položky:
File Edit Search View Project Run Components Tools Environment Windows Help
Ako je zvykom, položky môžu bať vybraté umiestnením myši nad položku menu a kliknutím ľavým tlačítkom myši alebo stlačením Alt-F na klávesnici (základné okno musí mať fokus, ak ho nemá stláčajte opakovane TAB na prepínanie fokusu medzi oknami, kým nie je titulkový pruh cieľového okna zvýraznený farbou).
Menu File
- New Unit: Vytvorí nový súbor jednotky (zdrojový kód Pascal).
- New Form: Vytvorí nový formulár: vrátane pripojeného zdrojového súboru Pascal.
- New ...: Poskytuje (pop-up menu box) s rôznymi typmi nových dokumentov.
- Open: Otvorí dialóg pre otvorenie existujúceho súboru.
- Revert: Ruší vykonané editácie a obnovuje súbor do pôvodného stavu.
- Open Recent: Zoznam naposledy otvorených súborov.
- Save: Uloží aktuálny súbor. Ak súbor ešte nemá meno, správa sa ako Save As.
- Save As: Umožňuje vybrať adresár a meno pre uloženie aktuálneho súboru.
- Save ALL:
- Close: Zatvorí aktuálny súbor, spýtajúc sa na uloženie vykonaných úprav.
- Close all editor files: Zatvorí všetky aktuálne otvorené súbory, spýtajúc sa na uloženie úprav.
- Clean directory: Otvorí dialóg s nastaviteľnými filtrami, pre odstránenie súborov z aktuálneho adresára. Užitočné pre odstránenie súborov .bak a zvyškov projektov Delphi.
- Restart:
- Quit: Zatvorí Lazarus, spýtajúc sa na uloženie vykonaných úprav.
Menu Edit
- Undo: Vrátenie poslednej editovanej akcie, ponechajúc Editor v stave tesne pred ňou.
- Redo: Opakovanie poslednej akcie, ktorá bola vrátená pomocou Undo.
- Cut: Vystrihne vybraný text a uiestni ho do schránky.
- Copy: Prekopíruje vybratý text do schránky.
- Paste: Vloží obsah schránky na pozíciu kurzora. Ak bol vybratý text, prepíše ho.
- Indent selection: Posúva odsadenie vybratého textu doprava o rozsah zadaný v nastavení Environment -> Editor options -> General -> Block indent. Funkciaje užitočná pre formátovanie zdrojovéhokódu a vyvorenie blokovej štruktúry.
- Unindent selection: Odstraňuje jednu úroveň odsadenia, posunúc text doľava o rozsah zadaný v nastavení Editora Block indent.
- Enclose selection: Otvára pop-up menu s voľbami pre logické zakončenie vybratého textu (begin ... end; try ... except; try ... finally; repeat ... until; { ... } atď).
- Uppercase selection: Konvertuje vybratý text na veľké písmená.
- Lowercase selection: Konvertuje vybratý text na malé písmená.
- Tabs to spaces in selection: Konveruje všetky tabulátory vybratého textu na medzery, podľa nastavenia Environment -> Editor options -> General -> Tab widths. Počet medzier nemá fixnú veľkosť, ale je to potrebný počet medzier na zaplnenie potrebnej šírky tabelátora medzerami.
- Break lines in selection: Zalomí riadok vybratého textu, ktorý presahuje 80 znakov alebo počet zadaný v nastavení Environment -> Editor options -> Display -> Right Margin, riadok je zalomený na hranici slova a pokračuje na nasledujúcom riadku.
- Comment selection: Vloží značky komentára // na každý riadok vybratého textu.
- Uncomment selection: Odstráni značky komentára.
- Insert $IfDef:
- Sort selection: Zoradí riadky (alebo slová v odstavci) podľa abecedy; voľby pre smer radenia, citlivosť na veľkosť písmen. Uprostred zrojového kódu, samozrejme, to neprichádza do úvahy, ale ak máte zoznam, ktorý treba zoradiť, oceníte tento trik.
- Select: Umožní výber blokov textu. Voľby zahŕňajú Vybrať všetko, vybrať po brace, vybrať odstavec alebo riadok, atď.
- Insert from character map: Umožní vloženie symbolu, ktorý nie je na klávesnici, vybratý z pop-up mapy znakov.
- Insert text: Zobrazí pop-up menu pre vloženie štandartných textov, ako kľúčové slová CVS (Author, Date, Header atď), či poznámku GPL, meno užívateľa, dátum a čas.
- Complete code: Dokončí kód pod kurzorom. Závisí od kontextu a šetrí mnoho času. Napríklad dokončuje triedy, pridaním súkromných premenných, prístupové metódy Get a Set vlastností a pridaním tela metód. Na priradeniach premenných (tj. i:=3;) pridáva deklaráciu premennej. Pri forward deklarovaných procedúrach pridáva telá procedúr. Pri priradení udalostí (OnClick:=) pridáva definíciu a telo metódy. Viď Lazarus IDE Tools.
- Extract procedure: Použije vybratý text (príkaz alebo sériu príkazov) na vytvorenie novej procedúry.
Menu Search
- Find: Obdoba vlastnosti skoro všetkých grafických editorov: pop-up dialógový box pre zadanie hľadaného textu a volieb hľadania, ako citlivosť na veľkosť písmen, celé slová, začiatok, oblasť a smer hľadania.
- Find Next, Find previous: Pokračuje v hľadaní predtým zvoleného textu, zadaným smerom.
- Find in files: Hľadá textový reťazec v súboroch: pop-up dialód s voľbami všetky otvorené súbory, všetky súbory v projekte alebo všetky adresáre; umžňuje i zadanie masky pr výber typu súboru.
- Replace: Podobné ako Find; zobrazí pop-up dialóg s miestom pre zadanie hľadaného reťazca a nahradzujúceho textu a volieb pre citlivosť na veľkosť písmen, smer atď.
- Incremental find: Hľadanie reťazca kým zadávate hľadaný reťazec. Príklad: stlačíte "l" a je zvýraznené prvé "l", ak potom stlačíte "a", editor nájde nasledujúce "la" atď.
- Goto line: Presunie kurzor na zadaný riadok súboru.
- Jump back: Presunie kurzor späť k nasledujúcej záložke (musíte použiť Add jump point to history). Presúva i na záložky iných súborov otvorených v Editore.
- Jump forward: Presunie kurzor vpred na nasledujúcu záložku.
- Add jump point to history: Pridá do súboru záložky alebo skokové body.
- View Jump-History: Ukáže zoznam záložiek v súbore: Zatiaľ neimplementované???.
- Jump to next error:
- Jump to previous error:
- Find other end of code block: Ak je kurzor umiestnený na begin, presunie kurzor na príslušný end a naopak.
- Find code block start: Presunie kurzor na begin procedúry alebo funkcie, v tele ktorej je umiestnený.
- Find Declaration at cursor: Presunie kurzor na miesto deklarácie zvoleného identifikátora. Môže to byť v rovnakom súbore alebo v inom. Ak nie je otvorený, otvorí ho v Editore (tak ak je procedúra alebo funkcia deklarovaná napr. v classesh.inc , tento bude otvorený v Editore).
- Open filename at cursor: Otovorí súbor, ktorého meno je vybraté kurzorom. Užitočné na zobrazenie Include súborov alebo súborov obsahujúcich iné Jednotky použité v projekte.
- Goto include directive: Ak je kurzor umiestnený v súbore, ktorý je Included v inom súbore, presunie kurzor na miesto v súbore, odkiaľ bol volaný súbor Include.
Menu View
Ovládanie zobrazenie rôznych okien a panelov na obrazovke.
- Object Inspector: TOkno, zvyčajne umiestnené na ľavej strane obrazovky, ktoré zobrazuje funkcie formulára, ktorý je na obrazovke. Kliknutím mišou na ktorýkoľvek komponent formulára, spôsobí, že detaily komponentu budú zobrazené v Object Inspector. Na jeho vrchu je panel, ktorý zobrazuje stromovú štruktúru aktuálneho projektu a komponenty formulára môžu byť vybraté aj z tohoto panela. Základný panel má dve záložky, ktoré umožňujú zobraziť Properties alebo Events. Výber Properties zobrazí vlastnosti zvoleného komponentu v dvoch stĺpcoch, ľavý zobrazuje meno vlastnosti a pravý jej hodnotu. Výber Events zobrazí tiež dva stĺpce, ľavý s menom udalostí priradených ku komponentu a pravý ukazuje akciu, ktorá je výsledkom udalosti (procedúru udalosti). Ak nie je definovaná akcia, kliknutie na tlačítko ...spôsobí zobrazenie Editora zdrojového kódu s kurzorom umiestneným na prázdenj deklarácii procedúry, do ktorej môžete zadať svoj kód udalosti.
- Source Editor: Základné okno pre editovanie zdrojového kódu. Jeho správanie je veľmi podobné iným grafickým editorom textu, takže môžete myšou presúvať kurzor nad zobrazeným textom a stlačenie ľavého tlačítka myši počas posúvania vyberie a označí text. Pravým kliknutím zobrazíte kontextové menu, ale ak ste zvyknutý na editory Windows, Gnome alebo KDE, budete márne hľadať zvyčajné funkcie, ako Vystrihnúť, Kopírovať a Vložiť, ale zahŕňa voľby ako Find Declaration alebo Open File at Cursor. Na vrchu okna Editora zdrojového kódu je niekoľko záložiek, reprezentujúcich otvorené súbory; kliknutie na jednu z nich vyvolá daný súbor do popredia, takto môžete jednoducho kopírovať zo súboru do súboru a vykonávať bežné editovacie funkcie. Editor zdrojového kódu poskytuje farebné zvýraznenie syntaxe kódu, s rôznymi farbami pre interpunkciu, komentáre, reťazcové konštanty atď. Rovnako zabezpečuje automatické odsadenie riadkov kódu. Funkcie a zhľad Editora zdrojového kódu sú nastaviteľné cez menu Environment -> Editor options a zvolením jednej z viacerých záložiek.
- Code Explorer: Okno, zvyčajne umiestnené na pravej strane pracovnej plochy, ktoré v stromovej forme zobrazuje štruktúru kódu aktuálnej jednotky alebo programu. Ak zmeníte súbor zobrazený v okne Editora zdrojového kódu, musíte zvoliť tlačítko Refresh na zobrazenie novej štruktúry súboru. Okno po otvorení zvyčajne zobrazuje meno jednotky a vetvy pre časti Interface a Implementation, ale kliknutím na +vľavo od vetvy otvoríte podvetvy a vetvičky :-), do úplných detailov samotných konštánt, typov apremenných, ako ja deklarácií procedúr a funkcií.
- Units...: pop-up dialóg so zoznamom súborov jednotiek aktuálneho projektu, ktorý umožní vybrať súbor Zobrazený v Editore zdrojového kódu. Zaškrtnutím voľby Multi select môžete vybrať a otvoriť viac jednotiek naraz, ale len jedna bude zobrazená. Táto položka menu je lepšia ako položka Project -> Project Inspector, ale zobrazuje len zoznam jednotiek a dovoľuje ich otvoriť.
- Forms...: pop-up dialóg so zoznamom formulárov aktuálneho projektu a umožní vybrať jeden alebo viac z nich pre zobrazenie.
- View Unit Dependencies: pop-up dialóg, ktorý zobrazí stromovú štruktúru závislostí aktuálne otvorenej jednotky. Mnoho súborov zobrazených v tomto okne má svoje svoje vlastné +, ktoré umožňujú preskúmať ich vlastné závislosti, často rekurzívnym spôsobom.
- View Unit Information:
- Toggle form / unit view F12: Prepína zobrazenie Formulár/Zdrojový kód formulára. Jednoduchším spôsobom je stlačenie F12 na klávesnici, ale táto položka menu má rovnaký význma.
- Messages: Okno so správami prekladača, zobrazuje postup úspešného prekladu alebo vypisuje nájdené chyby.
- Search Results: Okno s výsledkom hľadania textu v súboroch.
- View Anchor editors:
- Debug windows: pop-up menu s niekoľkými voľbami pre činnosť a konfiguráciu Debuggera. debugger je popísaný ďalej.
Menu Project
- New Project: Vytvorí nový projekt a poskytuje možnosť zvoliť typ projektu.
- New Project from file: Umožní vytvoriť nový projekt z existujúceho súboru.
- Open Project: Otvorí projekt, ktorý už bol vytvorený a uložený. Dialóg ponúkne zoznam súborov Lazarus Project Information (.lpi), z ktorých si môžete vybrať.
- Open Recent Project: Otvorí projekt zo zoznamu naposledy spracovávaných projektov.
- Save Project: Obdoba File -> Save: uloží všetky súbory aktuálneho projektu; ak ešte neboli uložené, ponúkne dialóg na zadanie mena (ako Save Project As...).
- Save Project As...: Požiada meno súboru pre uloženie projektu. Ponúkne prednastavené meno súboru Project1.lpi, ale môžete si zvoliť vlastné. Lazarus nedovoľuje použiť rovnaké meno súboru pre súbor projektu a súbor jednotky. Viz nižšie).
- Publish Project: Vytvorí kópiu celého projektu. Bežný adresár projektu obsahuje veľa informácií, ktoré nie je potrebné publikovať (informácie o session, súbory .ppu, .o, .exe. Publish Project vytvorí súbor .lpi obsahujúci len základné informácie a do kópie presunie len zdrojové kódy, zo všetkych podadresárov. V dialógu môžete nastaviť filter exclude/include a spôsob kompresie výstupného archívu. Viz Lazarus IDE Tools
- Project Inspector: pop-up dialóg so stromovou štruktúrou súborov aktuálneho projektu. Dovoľuje pridať, odstrániť alebo otvoriť zvolené súbory alebo zmeniť vlastnosti projektu.
- Project Options...: pop-up dialóg s voľbami nastavenia projektu (titulok, meno cieľového súboru), Forms (dovoľuje výber z dostupných formulárov, a ich nastavenie Auto-create) a Info (určuje, či editačné informácie majú byť uložené pre zatvárané súbory alebo len pre súbory projektu).
- Compiler options ...: Konfigurácia prekladača, zahŕňa záložky: Paths definícia ciest hľadania jednotiek, include súborov, knižníc... ako aj voľbu pomocného typu formulára (gtk, gnome, win32); Parsing voľba pravidiel pre syntaktickú analýzu programov, Code voľby optimalizácie pre rýchlejšie alebo pomalšieprogramy, výber cieľového procesora, veľkosti halsy atď; Linking voľby použitia ladenia, statických alebo dynamických knižníc atď; Messages typy správ, generované pri výskyte chyby; Other určenie predvoleného konfiguračného súboru (fpc.cfg) alebo iného súboru; Inherited stromový diagram ukazujúci voľby zdedené z už zahrnutých jednotiek; Compilation dovoľuje zadať príkazy vykonávané pred/po spustení prekladača a použitie súborov Make.
- Add editor file to Project: Do projektu pridá súbor, ktorý je práve upravovaný.
- Remove from Project: pop-up menu na odstránenie súboru z projektu.
- View Source: Bez ohľadu na to, ktorý súbor je práve upravovaný, zobrazí základný programový súbor (.dpr) alebo základný súbor .pas, ak .dpr neexistuje.
- View ToDo List: Otvorí dialóg so zoznamom položiek ToDo patriacich k projektu. Zobrazí zoznam všetkých komentárov ToDo vo vašom projekte (riadky začínajúce //TODO) a tiež všetky ostatné v jednotkách Lazarus, ktoré práve používate. Na to, aby sa objavili nové položky ToDo musíte použiť Refresh (pomocou tlačítka panela nástrojov). Prvý stĺpec zoznamu ToDo obsahuje číslo umiestnené vo vašom komentári ToDo; teda //TODO sa objaví ako 0, ale //TODO999 (napríklad) bude mať v prvom stĺpci číslo 999.
Menu Run
- Build: Preloží všetky súbory projektu, ktoré boli zmenené od posledného prekladu.
- Build all: Prekladá všetky súbory projektu, bez ohľadu na to, či boli alebo neboli zmenené.
- Abort build: Zastaví proces prekladu, ktorý je spustený - či už sa spamätáte, že máte niečo zle a chcete zastaviť preklad, alebo systém pracuje veľmi dlho a niečo je obvykle zle.
- Run: Obvyklý spôsob spustenia prekladača a, ak je preklad úspešný, spustenia aplikácia. Lazarus uloží kópie súborov, potom spustí prekladač a linker, potom začne vykonávať finálny programový súbor (.exe).
- Pause: Preruší vykonávanie aktuálne bežiaceho programu. Tým vám umožní skontrolovať akýkoľvek výstup, ktorý bol generovaný; vykonávanie môže pokračovať opätovným vybratím Run.
- Step into: Used in conjunction with the debugger, causes execution of the program one step at a time up to a bookmarked point in the source.
- Step over: Causes stepwise execution up to the statement marked, then skips the marked statement, and continues execution at normal speed. Useful in trying to isolate a statement that introduces a logical error.
- Run to cursor: Spôsobí vykonávanie programu normálnou rýchlosťou (tj. nie jeden príkaz naraz) pokiaľ nedôjde po príkaz, na ktorom je umiestnený kurzor; potom zastaví. Pokračovanie vykonávania normálnou rýchlosťou dosiahnete zvolením Run.
- Stop: Spôsobí zastavenie vykonávania bežiaceho programu. Nasledujúce zvolenie Run nepokračuje vo vykonávaní, ale spustí program od začiatku (ak treba i s prekladom).
- Run Parameters: Otvorí viacstránkové pop-up okno, v ktorom môžete tadať voľby a parametre príkazového riadku pre spustenie programu; výber zobrazenia spusteného programu (tj. môžete použiť vzdialený X terminál terminal v Linuxe); môžete prepísať niektoré systémové premenné.
- Veľmi zaujímavou možnosťou tohoto sub-menu je aktivácia okna terminálu pre zobrazenie vstupu/výstupu konvenčnej konzoly Pascalu. Ak pracujete na konzolovom programe Pascalu, (tj. nepoužijete pre program GUI s formulármi, tlačítkami...), potom môžete zaškrtnúť políčko "Use launching application". Keď to nastavíte prvý krát a skúsite sekvenciu Compile/Run, asi dostanete divoké hlásenie hovoriace "xterm: Can't execvp /usr/share/lazarus//tools/runwait.sh: Permission denied".
- Ak toto nastane, potrebujete zmeniť povolenia príslušného súboru; možno to budete musieť urobiť ako root (administartor). Potomto, sa pri každom spustení programu objaví konzolové okno a všetky vaše textové vstupy/výstupy budú pracovať v ňom (readln, writeln ...).
- Po skončení práce vášho programu sa objaví na obrazovke správa "Press enter". Takto celý výstup generovaný vašim programom ostane na obrazovke, aby ste mali šancu prečítať si ho a okno bude zatvorené až po stlačení 'enter'.
- Reset debugger: Obnovuje debugger do jeho pôvodného stavu, všetky ladiace body a hodnoty premenných... sú zabudnuté.
- Build file: Preloží súbor, ktorý je aktuálne otvorený v Editre zdrojového kódu.
- Run file: Preloží, spojí a spustí aktuálne otvorený súbor.
- Configure Build + Run File: Otvorí viacstránkové okno s voľbami, ktoré nastavia preklad práve tohoto súboru pri výbere Build Project, dovolia výber pracovného adresára, použitie rôznych makier... Potom preloží a spustí súbor.
- Inspect :
- Evaluate/Modify:
- Add watch:
- Add brak point:
Menu Components
- Open Package: Zobrazí zoznam nainštalovaných balíčkov, s možnosťou otvoriť jeden alebo viac z nich, alebo výber rôznych všeobecných volieb alebo volieb prekladača.
- Open Package File: Otvorí jeden zo súborov vo zvolenom balíčku.
- Open package of current unit:
- Open Recent Package: Ponúkne zoznam naposledy otvorených balíčkov.
- Add Active Unit to Package: Pridá aktuálny súbor (otvorený v editore) do balíčka.
- Package Graph: Zobrazí graf vzťahov jednotlivých balíčkov, ktoré sú používané (ak nepoužívate žiadny iný balíček, budú zobrazené balíčeky Lazarus, FCL a LCL).
- Configure custom components: táto položka už nie je...
Menu Tools
- Configure custom tools: Umožňuje užívateľovi pridať do nástrojov rôzne externé nástroje (zvyčajne makrá).
- Quick syntax check: Vykoná rýchlu kontrolu syntaxe vášho zdrojového kódu bez skutočného prekladu. Základný krok pri vývoji veľkých alebo komplikovaných programov, ak nechcete mrhať čas prekladom chybného kódu.
- Guess unclosed block: Užitočný nástroj, ak máte zložitú alebo vnorenú blokovú štruktúru a chcete niekde nájsť end.
- guess misplaced IFDEF/ENDIF: Užitočné, ak ak máte zložitú alebo vnorenú štruktúru makra a potebujete níjsť direktívu ENDIF.
- Make resource string:
- Diff: Umožňuje porovnanie dvoch súborov (alebo dvoch verzií rovnakého súboru) a nájdenie rozdielov. Poskytuje voľby na ignorovanie prázdneho miesta na začiatku alebo konci riadkov alebo rôznych zakončení riadkov (CR+LF a LF). Užitočné na kontrolu, či boli urobené zmeny od poslednej aktualizácie CVS atd.
- Check LFM file in editor: Umožňuje kontrolu súboru LFM, ktorý obsahuje nastavenia aktuálneho formulára.
- Convert Delphi unit to Lazarus unit: Pomáha pri prenose aplikácií Delphi do Lazarus; robí potrebné zmeny v zdrojovom súbore. Viz Prechod z Delphi na Lazarus a Code Conversion Guide.
- Convert DFM file to LFM: Pre prenos z Delphi do Lazarus. Viz Prechod z Delphi na Lazarus and Code Conversion Guide.
- Build Lazarus: LaunSpúšťa znovuzostavenie Lazarus z naposledy stiahnutých alebo aktualizovaných súborov CVS (proces môžete sledovať v okne Messages).
- Configure "Build Lazarus": Umožňuje určiť, ktoré časti Lazarus budú znova zostavené a ako. Napríklad, môžete nastaviť, že bude preložená len LCL alebo všetko okrem príkladov. Môžete nastaviť ktoré rozhranie LCL použiť a môžete nastaviť cieľový operačný systém, či nastaviť iný cieľový adresár.
Menu Environment
- Environment options: viacstránkové okno so záložkami pre
- Files - cesty k predvolenému adresáru, prekladaču, zdrojovému adresáru a dočasnému adresáru pre prekladanie;
- Desktop - voľby pre jazyk, správanie automatického ukladania, ukladanie vlastností pracovnej plochy, hinty pre paletu komponentov a speed tlačítka;
- Windows - zadanie veľkosti a správania rôznych okien;
- Form Editor - výber farieb pre editovanie formulárov;
- Object Inspector - výber farieb a veľkosti položiek;
- Backup - udáva ako zálohovať súbory pri úpravách;
- Naming - udáva príponu názvos súborov Pascalu ('.pp' alebo '.pas'), či sa majú ukladať malými písmenami, či vykonávať automatické mazanie alebo premenovanie.
- Editor options: viacstránkové okno so záložkami pre
- General - určuje správanie ako automatické odsadenie, zvýrazňovanie zátvoriek, drag-drop upravovanie, posúvanie, zvýrazňovanie syntaxe, zobrazovanie hintov, veľkosť odsadenia bloku a tabulátora, hranicu Undo;
- Display - voľby pre zobrazovanie čísel riadkov, zobrazovanie guttera, veľkosť a typ fontu editora a okno so zobrazením farieb rôznych typov syntaxe, ako komentáre, značky, direktívy, chyby a ladiace body;
- Key Mappings - voľby pre výber schémy Lazarus alebo Turbo Pascal;
- Color - umožňuje nastaviť farebnú schému textu pre viac typov jazyka, ako Object Pascal, C++, Perl, HTML, XML a skripty shellu. Zobrazuje aj ukážkový panel (pre zvolený jazyk);
- Code Tools - umožňuje výber funkcií ako Identifier Completion, tooltips, zadanie šablón názvov súborov, šablóny pre dokončovanie kódu.
- Debugger Options: viacstránkové okno so záložkami pre
- General - voľby debugera: bez, GNU debugger (gdb) alebo gdb cez SSH, zadanie vyhľadávacej cesty a volieb pre zvolený debugger;
- Event log - nastavenie, či zmazať log pri spustení a ktoré správy zobrazovať;
- Language Exceptions - výber výnimiek, ktoré budú ignorované;
- OS Exceptions - umožňuje pridať isté signály, ktoré aplikuje na aktuálny operačný systém.
- Code Tool Options: viacstránkové okno so záložkami pre
- General - zadanie ďalších ciest pre hľadanie zdrojových súborov a určenie metódy Jumping Method;
- Code Creation - určuje, či je vytváraný kód pridaný pred alebo za určitú funkciu;
- Words - určuje, či sú kľúčové slová Pascal zadávané malými alebo veľkými písmenami, alebo s veľkými počiatočnými písmenami;
- Line Splitting - zavádza pravidlá zalamovania riadkov (pred alebo po interpunkčných znamienkach, za kľúčovým slovom atď);
- Space - určuje či sú medzery automaticky pridané alebo za určité snktaktické črty, ako kľúčové slová, alebo interpunkčné značky.
- Code Tools Defines Editor:
- Re-scan FPC Source directory Znova prechádza adresár. Lazarus používa zdrojové kódy FreePascal na generovanie správnych obslúh udalostí a pri hľadaní deklarácií. Ak niekto zmení adresár v nastavení prostredia, potom je tento adresár znova prehľadaný, aby bolo zaistené, že Lazarus používa verziu uchovanú v danom umiestnení. Ale ak bol tento adresár zmenený a Lazarus nebol o tom informovaný, potom sa môžu objaviť chyby pri navrhovaní formulárov alebo vykonaním "Find declaration". Ak sa stretnete s touto chybou, môžete urobiť dve veci:
- skontrolovať nastavenie zdrojového adresára vo voľbách prostredia.
- znova prehľadať zdrojový adresár FreePascal.
Menu Windows
Obsahuje zoznam aktuálne otvorených súborov a dostupných okien, ako Source Editor, Object Inspector, či Project Inspector. Kliknutím na názov jedného z okien je okno vyvolané do popredia a získava zameranie.
Menu Help
At present this has three selections:
- Online Help otvorí okno prehliadača so súborom c:/lazarus/docs/index.html, ktoré obsahuje obrázok bežiacej cheetah a niekoľko odkazov nafew links to the Lazarus, FreePascal and WiKi websites
- Configure Help umožňuje nastaviť prehliadač a databázy, z ktorých budú čítané informácie nápovedy. Tieto voľby dovoľujú užívateľovi zadať jeden z on-line dokumentov na webovej stránke Lazarus-CCR, niektoré ďalšie webové stránky obsahujúce dokumenty, alebo lokálne umiestnenie dokumentácie. Predvolene, ak umiestnite kurzor nad kľúčové slovo FCL alebo RunTime Library (ale nie LCL) a potom stlačíte <<F1>> dostanete sa na príslušnú stránku.
- About Lazarus Zobrazí pop-up box s informáciami o Lazarus.
Časom tu bude úplný on-line Help, s informáciami o syntaxe Pascalu, o použití IDE, o používaní, úpravách a tvorbe komponentov a tipy ako urobiť niektoré úlohy. Táto časť sekcie Dokumentácia (to čo teraz čítate) predstavuje začiatok procesu. Potrebujeme spolupracovníkov, ktorí sú ochotní pomôcť: Editácia WiKi je veľmo jednoduchá.
Paleta komponentov
A Tabbed toolbar which displays a large number of icons representing commonly used components for building Forms.
Each tab causes the display of a different set of icons, representing a functional group of components. The left-most icon in each tabbed group is an obliquely leftward-facing arrow, called the Selection Tool.
If you allow the mouse cursor to hover over any of the icons on the Component Palette, without clicking on the icon, the title of that component will pop-up. Note that each title begins with a 'T' - this signifies 'Type' or more accurately 'Class' of the component. When you select a component for inclusion in a form, the Class is added to the type section of the interface part of the Unit (usually as part of the overall TForm1), and an instance of that class is added to the var section (usually as the variable Form1). Any Methods that you design to be used by the Form or its Components (ie Procedures or Functions) will be placed in the implementation part of the Unit
In the following list of the Components, you will find links to files that contain descriptions of the Units in which they are found. If you want to find out about the properties of a particular component, it is often worth looking at the Inheritance of that component and then inspecting the properties of the base type from which it is derived. For example, to understand TMaskEdit it is also useful to examine TCustomMaskEdit.
TABS (the names are largely self-explanatory):
Standard
- Frequently used components: TMainMenu, TPopupMenu, TButton, TLabel, TEdit, TMemo, TToggleBox, TCheckBox, TRadioButton, TListBox, TComboBox, TScrollBar, TGroupBox, TStaticText, TRadioGroup, TCheckGroup, TPanel, TActionList
Additional
- More, often-used components: TBitBtn, TSpeedButton, TImage, TShape, TBevel, TPaintBox, TNotebook, TLabeledEdit, TSplitter, TMaskEdit, TCheckListBox, TScrollBox, TApplicationProperties, TStringGrid, TDrawGrid, TPairSplitter
Common Controls
- TTrackBar, TProgressBar, TTreeView, TListView, TStatusBar, TToolBar, TUpDown, TPageControl, TImageList
Dialogs
- TOpenDialog, TSaveDialog, TSelectDirectoryDialog, TColorDialog, TFontDialog, TOpenPictureDialog, TSavePictureDialog, TCalendarDialog, TCalculatorDialog
Several useful Dialog procedures or functions don't appear on the Palette, but are easily used as direct calls from your source program.
For several good examples of the use of Components see the $LazarusPath/lazarus/examples subdirectory of your source installation. Many of the programs show how to use dialogs and other components directly without using the IDE and component palette or having a separate form definition file: all the components are fully and explicitly defined in the main Pascal program. Other example programs make full use of the IDE.
Some examples don't work straight away: you may need to play about with paths and permissions of files or directories. If you want to compile any of the examples, make sure that you have read/write/execute permissions for the files and directories, or copy the files to a directory where you do have the appropriate permissions.
Try running the 'testall' program to see a menu of the available components together with small example test forms for most of them; then inspect the code to find out how they work!
Misc
- TColorButton, TSpinEdit, TArrow, TCalendar, TEditButton, TFileNameEdit, TDirectoryEdit, TDateEdit, TCalcEdit, TFileListBox
Data Controls
- Data-aware components, which largely replicate the Standard and Additional groups but are applicable to Databases: TDBNavigation, TDBText, TDBEdit, TDBMemo, TDBImage, TDBListBox,TDBComboBox, TDBCheckBox, TDBRadioGroup, TDBCalendar, TDBGroupBox, TdbGrid
Data Access
- TDatasource
System
- TTimer, TIdleTimer, TProcess
SynEdit
- A group of components to help interfacing with other languages and software tools. SynEdit is an advanced multi-line edit control, for Borland Delphi, Kylix and C++Builder. It supports Syntax Highlighting and code completion, and includes exporters for html, tex and rtf. It is a full-VCL/CLX control, meaning it is not a wrapper for Microsoft Windows controls, and no run-time library is required; this make SynEdit a crossplatform component. Compatibility with FreePascal is also planned, and SynEdit is the edit component in Lazarus IDE. see synedit at sourceforge. TSynEdit, TSynAutoComplete, TSynExporterHTML, TSynMacroRecorder, TSynMemo, TSynPasSyn, TSynCppSyn, TSynJavaSyn, TSynPerlSyn, TSynHTMLSyn, TSynXMLSyn, TSynLFMSyn, TSynUNIXShellScriptSyn, TSynCssSyn, TSynPHPSyn, TSynTeXSyn, TSynSQLSyn, TSynMultiSyn
To use the Palette, there must be an open form on view in the editor (if there isn't one, select File -> New Form). Click on the icon in the appropriate tab of the Palette for the component you want to use, then click on the Form, near where you want the component to appear. When the desired component appears, you can select it by clicking with the mouse, then move it to the exact place on the Form where you want it and adjust its size. Adjustments can be made to the appearance either by altering the picture itself on the Form using the mouse, or by changing the relevant Property in the Object Editor for that component.
If you install additional components, either those you have written yourself, or some coming as a package from some other source, then extra tabs with the relevant icons will appear in your Component Palette. These new components can be selected and used on your forms in the same way as those supplied by default.
The Debugger
- Still to be written.
The Lazarus files
(Thanks to Kevin Whitefoot.) (Additions by Giuseppe Ridinò, User:Kirkpatc and Tom Lisjac)
When you save you will actually be saving two files:
xxx.pas and yyy.lpr
(You save more than that but those are the ones you get to name). The project file (lpr) and the unit file (pas) must not have the same name because Lazarus will helpfully rename the unit (inside the source code) to the same as the unit file name and the program to the name of the project file (it needs to do this or the compiler will probably not be able to find the unit later when referred to in the project file). Of course to be consistent it changes all the occurrences of unit1 to xxx.
So if you are saving a project called again, trying to save again.pas and again.lpr fails because unit names and program names are in the same name space resulting in a duplicate name error.
So here is what I ended up with:
e:/lazarus/kj/lazhello:
total 4740 free 76500 -rwxrwxrwx 1 kjwh root 4618697 Mar 24 11:19 again.exe -rw-rw-rw- 1 kjwh root 3002 Mar 24 11:21 again.lpi -rw-rw-rw- 1 kjwh root 190 Mar 24 11:18 again.lpr -rw-rw-rw- 1 kjwh root 506 Mar 24 11:08 againu.lfm -rw-rw-rw- 1 kjwh root 679 Mar 24 11:08 againu.lrs -rw-rw-rw- 1 kjwh root 677 Mar 24 11:08 againu.pas -rw-rw-rw- 1 kjwh root 2124 Mar 24 11:08 againu.ppu -rwxrwxrwx 1 kjwh root 335 Mar 24 11:07 ppas.bat
Note that there are many more files than the two that I thought I was saving.
Here is a brief note about each file:
again.exe: The main program binary executable. Win32 adds an "exe" extension. Linux has none. This file will be huge on Linux due to the inclusion of debugging symbols. Run the "strip" utility to remove them and substantially shrink the executable size.
again.lpi: This is the main file of a Lazarus project (Lazarus Project Information); the equivalent Delphi main file of an application will be the .dpr file. It is stored in an XML format.
again.lpr: The main program source file. Despite its lazarus specific extension it is in fact a perfectly normal Pascal source file. It has a uses clause that lets the compiler find all the units it needs. Note that the program statement does not have to name the program the same as the file name.
againu.lfm: This is where Lazarus stores the layout of the form unit. Lazarus uses this to generate a resource file that is included in the initialisation section of the againu.pas unit. Delphi dfm files can be converted to lfm format in the Lazarus IDE using the Tools->Convert DFM file to LFM utility.
again.lrs: This is the generated resource file. Note that it is not a Windows resource file.
againu.pas: The unit that contains the code for the form.
again.ppu: This is the compiled unit.
ppas.bat: This is a simple script that links the program to produce the executable. If compilation is successfull, it is deleted by the compiler.
Original contributors and changes
This page has been imported from the epikwiki version.
- Created initial page and template. T. Lisjac - 11/04/2003 VlxAdmin
- Inserted a note containing instructions for writing your first Lazarus Program. Suggest an administrator places it in the appropriate place on the Tutorial menu. 3/09/2004 User:Kirkpatc
- Per above, moved Chris's writeup to the main body of the tutorial VlxAdmin
- Began to insert text describing the Lazarus Editor - more to follow! 24 Mar 2004 User:Kirkpatc
- Added some more to Lazarus Editor section of Tutorial. 25 Mar 2004 User:Kirkpatc
- Added screenshots and revised some of the page formatting VlxAdmin 3/25/2004
- Moved some of kwhitefoot's comments into Tutorial section. Formatting not quite right, but have to go to bed now! 26 Mar 2004 User:Kirkpatc
- Formatted, added credits and comments. Removed original notes. VlxAdmin 3/26/2004
- More material added to Editor section of tutorial. 26 Mar 2004 User:Kirkpatc
- More material added describing the Main Menu. Renamed 'Hello World' to 'Getting Started' and moved it to nearer the top. 31 March 2004 User:Kirkpatc
- Inserted section on Run sub-menu. Some general editing (eg ended each entry with a period to ensure consistency). 9 Apr 2004 User:Kirkpatc
- Inserted a new section on How to get started with MySQL in FPC/Lazarus. 13 Apr 2004 User:Kirkpatc
- Deleted the section on MySQL from here: it has been copied to Lazarus Database section of tutorial. 14 Apr 2004 User:Kirkpatc
- Added some more to the description of the Editor Main Menu. 18 Apr 2004 User:Kirkpatc
- Added section on Environment sub-menu. 19 Apr 2004 User:Kirkpatc
- Added section on Components sub-menu. 4 May 2004 User:Kirkpatc
- Adding Tools sub-menu description (incomplete). 7 May 2004 User:Kirkpatc
- Added some screenshots to Menu descriptions. 9 May 2004 User:Kirkpatc
- Fixed a bit in Environment Options - thanks VincentSnijders. 14 May 2004 User:Kirkpatc
- More additions to Tools sub-menu. 19 May 2004 User:Kirkpatc
- Added a section on the Button Bar and started work on The Component Palette. 20 May 2004 User:Kirkpatc
- Posted a description file for the StdCtrls unit of the LCL, in the hope that people will add comments. 26 May 2004 User:Kirkpatc
- Edited the StdCtrls file, removing a lot of repetitive material and doing some formatting. It is still far too long. 28 May 2004 User:Kirkpatc
- Expanding on the Components Palette. 5 June 2004 User:Kirkpatc
- Added a lot to the DialogExamples page. 10 June 2004 User:Kirkpatc
- Considerable revision of the StdCtrls page, hopefully making it clearer and encouraging people to contribute - particularly in the 'Description' sections. 14 June 2004 User:Kirkpatc
- Added pages for Menus and Dialogs units (linked to Component Palette description) - please feel free to add to these pages. 14 June 2004 User:Kirkpatc
- Added page for Common Controls (linked to Component Palette). 16 June 2004 User:Kirkpatc
- Added MaskEdit page (linked to Component Palette). 17 June 2004 User:Kirkpatc
- Added Buttons, ExtCtrls pages (linked to Component Palette). 17 June 2004 User:Kirkpatc
- Edited MainMenu component description page. 23 June 2004 User:Kirkpatc
- Some additions to Common Controls. 28 June 2004 User:Kirkpatc
- A new tutorial on Text-mode Pascal programming has been added. 5 July 2004 User:Kirkpatc
- Minor changes to ComCtrls, ExtCtrls, Environment Menu. 10 July User:Kirkpatc
- Added FormsTxt, component description page for Component Palette. 20 July 2004 User:Kirkpatc
- Some corrections to ConsoleModePascal. 21 July 2004 User:Kirkpatc
- Some small changes to ComponentPalette. 22 July 2004 User:Kirkpatc
