Lazarus Tutorial/fi: what changed

Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		Tästä alkaa Lazarus Tutorial. Voit vapaasti parantaa sitä.
2	2
3	3		## Yleistä
4	4
5	5		Lazarus on vapaa avoimeen lähdekoodiin perustuva ohjelmankehitysympäristö joka pohjautuu [[FPC/fi\|FreePascal Compiler]] (object pascal), Joka on myös vapaa ja avointa lähdekoodia. Lazaruksen [[IDE/fi\|käyttöliittymä]] ([[Screenshots\|kuvakaappauksia]]) on vakaa ja ominaisuuksiltaan monipuolinen ohjelman kehitysympäristö jolla voi tehdä itsenäisiä [[Graphical User Interface/fi\|graafisia]] ja [[Command-line interface/fi\|komentorivillä]] toimivia sovelluksia. Se toimii Linux:ssa, [[FreeBSD]]:ssä, Win32:ssa, Mac:ssa ja on varustettu customoitavalla lähdekoodieditorilla ja visuaalisella lomakkeen muotoilulla jossa mukana komponenttipakettienhallinta, [[Debugger/fi\|virheenjäljitin]] ja täydelliset graafiset käyttöliittymäkomponentit integroituna FreePascal [[Compiler/fi\|kääntäjään]].
6	6
7	7		## Aloittaminen
8	8
9	9		Hanki, [[Installing Lazarus\|asenna]] ja käynnistä Lazarus jossa pitää olla Free Pascal Compiler mukana.
10	10
11	11		> Note: Ainakin Linux Ubuntussa, Lazaruksen käynnistyskomento on konsolissa (päätteessä) "startlazarus". Jos olet asentanut Lazaruksen Debianin pakettina, niin Lazarus pitäisi olla valikkokohdan Sovellus / ohjelmointi alla. (Huomaa: Debian ja Ubuntu tärkeimmät binary ja paketti on nimeltään "Lazarus-ide", koska on myös "TCT" paketti jossa mukana tulee apuohjelma nimeltä "Lazarus").
12	12
13	13		### Ensimmäinen Lazarus ohjelma!
14	14
15	15		Päävalikosta valitsemalla Projekti-Uusi projekti-Sovellus (tai: Tiedosto-Uusi-projekti-Sovellus) niin uusi graafinen sovellus luodaan, katso myös [[Form Tutorial\|Form opetusohjelma]] .
16	16
17	17		Useita ikkunoita ilmestyy työpöydälle: Päävalikkoikkuna yläreunassa, Komponenttimuokkain on vasemmalla, "Lähdekoodieditori" täyttää työpöydän ja valmis lomake "Form1" on omassa ikkunassa ([[TForm/fi\|Form1]] ) Lähdekoodieditorin päällä.
18	18
19	19		Jos halutaan sijoittaa painike lomakkeelle: Päävalikkoikkunan alaosassa on välilehtirivi. Jos "[[Standard tab/fi\|Standard]]" välilehti ei ole jo valittu, valitse se klikkaamalla hiirellä. Sen jälkeen etsii [[TButton/fi\|Button]] kuvakkeen (![](/wiki-images/b/b2/Tbutton.png) eli suorakulmio jossa on "OK"-teksti) ja klikkaa sitä hiirellä. Sitten Form1 ikkunassa klikataan jonnekin keskilinjan vasemmalla puolen. Varjostettu "Button1"-tekstillä merkitty suorakulmio ilmestyy siihen. Klikkaa jälleen Button kuvaketta Standard -välilehdellä ja klikkaa Form1-ikkunassa jonnekin oikealle keskelle: toinen "Button2"-tekstillä merkitty suorakulmio ilmestyy.
20	20
21	21		Nyt klikkaa Button1 jotta se valitaan. Komponenttimuokkainikkuna näyttää nyt kohteen Button1-ominaisuudet. Yläosassa on ominaisuus nimeltä 'Caption', jossa näytetään arvo "Button1". Klikkaa kyseistä kohtaa (ruudukkoa) ja muuta teksti "Button1" muotoon "Press". Jos painat `ENTER` tai klikkaat toista ruutua näet että Form1-lomakkella ensimmäisen painikkeen teksti muuttuu "Press":ksi. Nyt klikkaat Tapahtumat -välilehteä komponenttimuokkaimessa niin näet erilaisia tapahtumia, jotka voivat liittyä tähän Button1-painikkeeseen. Näitä ovat onClick, OnEnter, OnExit jne. Valitse onClick oikealla puolella oleva ruutu. Tällöin siihen ilmestyy pienempi laatikko kolmella pisteellä (...). Kun klikkaat tätä, se otetaan automaattisesti osaksi lähdekoodieditorissa ja kursorin sijoitetaan koodinpätkän keskelle:
22	22
23	23		``` pascal
24	24		procedure TForm1.Button1Click(Sender: TObject);
25	25		begin
26	26		{Kirjoita tai kopio&liitä tämä puuttuva osa:}
27	27		Button1.caption := 'Press again';
28	28		{Lähdekoodieditori on jo täydentänyt aliohjelman lopun}
29	29		end;
30	30		```
31	31
32	32		Painamalla `F12` nähdään lähdekoodieditorin sijasta lomakkeen Form1 ikkuna.
33	33
34	34		Nyt muokataan Button2 ominaisuuksia : klikkaa Button2 jotta nähdään sen ominaisuuksia komponenttimuokkaimessa. Muuta sen Caption [[Property\|ominaisuuteen (property)]] "Button2" tekstin tilalle "Exit". Valitse tapahtumat-välilehti ja klikkaa onClick. Klikkaa kolmea pistettä (...) ja sen jälkeen ollaan lähdekoodieditorissa, keskellä toisen Button2:n [[Procedure/fi\|aliohjelmaa]]:
35	35
36	36		``` pascal
37	37		procedure TForm1.Button2Click(Sender: TObject);
38	38		begin
39	39		{Kirjoita tai kopio&liitä tämä puuttuva osa:}
40	40		Close;
41	41		{Lähdekoodieditori on jo täydentänyt aliohjelman lopun}
42	42		end;
43	43		```
44	44
45	45		Painamalla `F12` nähdään lomakkeen Form1 ikkuna uudelleen. Tallenna nyt työsi (ja muista tehdä se usein !!) valitsemalla päävalikosta Projekti-Tallenna projekti nimellä \> sinun_valitsemalla_tiedosto_nimellä. Talletettavana on kaksi erilaista [[File extension/fi\|tiedostonimipäätettä]] (.pas ja .lpi). Valitse näille eri nimet. Jos molemmat ovat samannimisiä niin saat "duplicate identifier" [[compile-time error/fi\|käännösvirheen]] (katso luku "The Lazarus tiedostot" lopussa tämän aiheen lopussa).
46	46
47	47		Voit nyt yrittää kääntää. Yksinkertaisin tapa tehdä on valita "Suorita" päävalikon yläreunasta ja sitten "Suorita" vaihtoehto alivalikosta. Vaihtoehtoisesti voit yksinkertaisesti painaa `F9`. Tämä ensin kääntää ja sitten (jos kaikki on hyvin) linkittää sekä suorittaa kyseisen ohjelman.
48	48
49	49		Kääntäjän viestit ikkuna tulee näkyville ja kaikenlaisia kääntäjä viestejä siihen kirjoitetaan, mutta lopulta sinun Form1 ikkuna ilmestyy näyttöön uudelleen, mutta ilman ruudukon pisteitä. Tämä sovelluksesi pääikkuna ja se odottaa että sinä painat painonappeja tai olet muutoin vuorovaikutuksessa sen kanssa.
50	50
51	51		Kokeile klikkaamalla painiketta joka on nimetty tekstillä "Press". Huomaat, että sen teksti muuttuu "Press again" tekstiksi. Jos painat sitä uudelleen, sen teksti on silti "Press again" !!
52	52
53	53		Nyt klikkaat painiketta joka on nimetty tekstillä "Exit". Ikkuna sulkeutuu ja ohjelma päättyy. Alkuperäinen Form1 ikkuna ruudukon pisteillä ilmestyy uudelleen ja on valmis hyväksymään lisää muokkausta toimintaansa.
54	54
55	55		### Muokkaa ohjelmaa
56	56
57	57		Uudelleen avaa tallennettu projekti. Sen Form1 ikkunassa klikkaa "Press" painiketta (Button1) valitseksesi se. Valitse "Tapahtumat" -välilehti komponenttimuokkaimessa, klikkaa onClick:n oikealla puolella olevaa ruutua, klikkaa kolmea pistettä (...), jolloin siirryt oikeaan kohtaan lähdekoodieditorissa.
58	58
59	59		Muokkaa kyseinen kohta koodia seuraavanlaiseksi:
60	60
61	61		``` pascal
62	62		procedure TForm1.Button1Click(Sender: TObject);
63	63		{Hyödynnetään Tag ominaisuutta, se saa arvot 0 tai 1}
64	64		begin
65	65		if Button1.tag = 0 then
66	66		begin
67	67		Button1.caption := 'Press again';
68	68		Button1.tag := 1;
69	69		end else
70	70		begin
71	71		Button1.caption := 'Press';
72	72		Button1.tag := 0;
73	73		end;
74	74		end;
75	75		```
76	76
77	77		Tallenna työsi, uudelleen käännä ja suorita. Vasen painike nyt vaihtaa tekstiä kahden vaihtoehdon välillä.
78	78
79	79		Loput on sinusta kiinni!
80	80
81	81		Jos haluat kirjoittaa konsoli(pääte)- tai tekstipohjaisia Pascal ohjelmia (esimerkiksi jos seuraavana on perustiedot Pascal ohjelmoinnista kurssi tai täytyy kirjoittaa ohjelmia joita käytetään eräajona tai järjestelmäohjelmointia), voit silti käyttää Lazarus muokkaamaan , kääntämään ja ajamaan ohjelmia. Katso [[Console Mode Pascal/fi\|Komentoriviohjelmointi Pascalilla]].
82	82
83	83		## Kehitysympäristön ikkunat
84	84
85	85		Kun käynnistää Lazarus ensimmäistä kertaa niin joukko erillisiä irti olevia tai "kelluvia" ikkunoita näkyy työpöydällä.
86	86
87	87		Ensimmäinen, oikealla yläreunassa pitkittäin on otsikoitu "project1 - Lazarus IDE vXXXXXX" (jonka nimi muuttuu vastaamaan nimiä parhaillaan auki olevasta projektista). Tämä on tärkein ikkuna ja se sisältää mm päävalikon ja [[Component Palette/fi\|komponenttipaletin]].
88	88
89	89		![](/wiki-images/d/d0/Lazarus-IDE.jpg)
90	90
91	91		Otsikkopalkin alapuolella oleva rivi on päävalikko jossa on merkinnät Tiedosto, Muokka, Etsi, Näytä ja niin edelleen. Tämän alapuolella vasemmalla on joukko symboleja (kuvakkeita jotka vievät nopeasti tiettyihin valikkokomentoihin) ja oikealla on komponenttipaletti.
92	92
93	93		Tämän alle vasemmalla on komponenttimuokkain ('Object Inspector') ikkuna ja Lazaruksen lähdekoodieditori oikealla. Siellä voi olla toinen pienempi ikkuna joka on (aluksi) merkitty nimellä "Form1", Lazaruksen lähdekoodi-ikkunan päällä. Jos tämä ei ole näkyvissä heti, se voidaan saada näkymään painamalla `F12`. Kyseinen funktionäppäin vaihtaa vuorotellen lähdekoodieditorin ja lomakenäkymän välillä. Lomake (Form) ikkuna on se, johon voidaan rakentaa graafisen käyttöliittymän sovellukseen, kun taas lähdekoodieditorin ikkuna näyttää sovelluksen Pascal koodin jota kehitetään. Komponenttimuokkaimen toiminta on käsitelty tarkemmin alla, kun komponenttipaletti on ensin kuvattu. Lisäksi voi olla myös viesti -ikkuna näytön alareunassa: tätä käytetään näyttämään Lazaruksen palautetta ohjelmoijalle, esimerkiksi ohjelmaa käännettäessä.
94	94
95	95		Kun aloittaa uuden projektin (tai kun käynnistää Lazarus ohjelman kehitysympäristön) niin oletus lomake rakennetaan, joka koostuu laatikosta, jossa on pisteruudukko, joiden avulla voit sijoittaa eri komponentteja lomakkeelle ja lomakkeen yläpalkki, joka sisältää tavallisesti minimointi, maximointi ja Sulje-painikkeet. Jos klikkaat hiiren kohdistimella mihin tahansa tähän lomakkeeseen, näet vasemmalla puolen komponenttimuokkaimen joka kertoo tämän lomakkeen ominaisuuksia.
96	96
97	97		Muut ikkunat, jotka voivat tulla näkyviin työskentelyn aikana: Projektin hallinta, joka sisältää yksityiskohtaiset tiedot tiedostojen mukana olosta projektissa. Siinä voidaan lisätä tai poistaa tiedostoja projektista; Viesti-ikkuna, joka näyttää kääntäjän viestejä, virheitä tai edistymisraportteja projektista. Jos Lazarus käynnistettiin pääteikkunasta (konsoli) niin alkuperäinen pääteikkuna pysyy näkyvissä ja yksityiskohtaiset kääntäjän viestit tulostetaan myös siellä.
98	98
99	99		## Päävalikko
100	100
101	101		Päävalikko sisältää seuraavat nimikkeet:
102	102
103	103		Tiedosto Muokkaa Etsi Näytä Lähdekoodi Projekti Suorita-valikko Paketti Työkalut Ikkunat Ohje
104	104
105	105		Kuten tavallista, vaihtoehdot voidaan valita joko asettamalla hiiren osoitin valikkokohdan ja klikkaamalla hiiren vasenta painiketta.
106	106
107	107		Lisätietoja saat ottamalla yhteyttä [[Main menu/fi]].
108	108
109	109		## Pikapainikkeet
110	110
111	111		Pieni työkalurivi pääikkunan vasemmalla puolen, päävalikon alapuolelle jonka vasemmalla puolen on komponenttipaletti. Se sisältää joukon painikkeita, jotka ovat samoja kuin usein käytetyt päävalikon valinnat: Uusi käännösyksikkö, Avaa (jossa on alas-nuolta painamalla saadaan näyttämään avattavan listan viimeksi käytetyistä tiedostoista), Tallenna, Tallenna kaikki, Uusi lomake, Vaihda lomake / käännösyksikkö (eli näyttää joko lomakkeen tai käännösyksikön lähdekoodia), Näytä käännösyksiköt, Näytä lomakkeet, Suorita (eli kokoa ja suorita), Pysäytä, Askella sisään, Askella yli (kaksi viimeistä ovat virheenjäjityksen toimintoja).
112	112
113	113		## Komponenttipaletti
114	114
115	115		## Kuinka käyttää komponentteja
116	116
117	117		[[Unit/fi\|Käännösyksiköt]] StdCtrls, ComCtrls ja ExtCtrls sisältävät määritelmät ja kuvaukset moniin yleisimmin käytettyihin komponenteihin, lomakkeen rakentamiseen ja muihin objekteihin Lazarus sovelluksissa.
118	118
119	119		Sovelluskehittäjän usein lopullisena tavoitteena on että halutaan käyttää komponentteja kuten TButton, [[TMemo/fi\|TMemo]], [[TScrollBar/fi\|TScrollBar]] jne, näiden vastaava kantaisät ovat luokat TCustomButton, TCustomMemo tai TCustomScrollBar. Usein ominaisuuksia ja metodeiden merkitystä on määritelty (ja selitetty) täydellisemmin TCustomXXX luokassa ja ne periytyvät näihin lopullisiin tavoite komponentteihin.
120	120
121	121		Jos pudotat komponentin lomakkeelle niin silloin ei tarvita lisätä koodia luomaan sitä. Komponentti automaattisesti luodaan lomakkeen yhteydessä ja tuhotaan kun lomake on tuhottu. Jos kuitenkin luodaan komponentti (omatoimisesti) koodilla niin ei saa unohtaa sen vapauttamista, kun sitä ei enää tarvita.
122	122
123	123		#### Tapoja asettaa ominaisuuksia
124	124
125	125		Jos asetetaan komponentti lomakkeelle ja katsotaan komponenttimuokkaimella niin voidaan tarkkailla kun ominaisuudet muuttuvat, kun siirrät komponettia ympäriinsä.
126	126
127	127		Jos esimerkiksi asetetaan painike (TButton) lomakkeelle, valitaan se klikkaamalla sitä niin sen hiirellä siirtämistä ympäri lomaketta hiirellä, voidaan katsella Top ja Left arvojen muutosta vastaamaan uutta asentoon komponenttimuokkaimella. Jos käytetään objektin uudelleen mitoitusta säätämään sen kokoa niin voidaan katsella Height (korkeus) ja Width (leveys) ominaisuuksien muuttumista myös.
128	128
129	129		Toisaalta, käyttämällä komponenttimuokkainta voidaan valita arvon liittyvä ominaisuus, kuten height (korkeus), ja kirjoittaa siihen uusi arvo niin voidaan katsella lomakkeella kohteen koon muutosta vastaamaan uutta arvoa.
130	130
131	131		Voidaan myös nimenomaisesti muuttaa komponentin ominaisuuksia koodin kirjoittamalla (asianmukaisessa implementation lohkossa lähdekoodieditorissa), esimerkiksi
132	132
133	133		``` pascal
134	134		Form1.Button1.Height := 48;
135	135		```
136	136
137	137		Yhteenvetona, on yleisesti kolme erilaista tapaa määrittää jokaisen komponentin ominaisuuksia:
138	138
139	139		- hiiren avulla lomakkeella
140	140		- asettamalla arvot komponenttimuokkaimessa
141	141		- eksplisiittisesti kirjoittamalla koodia editorissa.
142	142
143	143		#### Yleisiä ominaisuuksia
144	144
145	145		Komponenttien käännösyksiköissä on määritelty useita ominaisuuksia, jotka ovat yhteisiä useimmille niistä ja muita ominaisuuksia jotka ovat ominaisia yksittäisille komponenteille. Yleisimpiä on kuvattu tässä. Epätavallisia tai okomponenttiriippuvaisia ominaisuuksia kuvataan tarkemmin komponettikohtaisissa ohjeissa.
146	146
147	147		Lisäohjeita saadaan valitsemalla ominaisuus tai avainsana, joko komponenttimuokkaimessa tai lähdekoodieditorissa ja painamalla `F1`. Tämä vie ohjeen oikealle sivulle dokumentaatiossa.
148	148
149	149		Jos ominaisuuden kuvaus on sivulla riittämätön, voidaan siirtyä katsomaan mistä se on peritty.
150	150
151		-	~~Joitakin yleisesti olevia ominaisuuksia~~
	151	+	```text
	152	+	<caption><b>Joitakin yleisesti olevia ominaisuuksia</b></caption>
	153	+	```
152	154
153	155		Ominaisuus
154	156
155	157		Merkitys
156	158
157	159		Action
158	160
159	161		Tärkein toiminta tai tapahtuma joka liittyy komponenttiin. Esimerkiksi valitsemalla "Lopeta" -painike saattaa aiheuttaa Sulje-toiminnan.
160	162
161	163		Align
162	164
163	165		Määrittää miten komponentti on sijoittunut vanhempaansa nähden. Mahdolliset arvot ovat alTop (sijoittuu yläosaan ja käyttää koko käytettävissä olevan leveyden), alBottom, alLeft (sijoittuu vasemmalle ja käyttäen koko käytettävissä olevan korkeuden), alRight. alNone (missä tahansa) tai alClient (käyttää kaiken käytettävissä olevan tilan)
164	166
165	167		Anchor
166	168
167	169		Käytetään pitämään komponentti tietyn etäisyyden päässä vanhemmasta komponentista, määritelty reunoista, kun vanhempi muuttaa kokoa. Esimerkiksi \[akBottom, akRight\] pitää komponentin kiinteän matkan päässä oikeaan alakulmaan.
168	170
169	171		AutoSelect
170	172
171	173		Kun sen arvo on True niin valitaan kaikki se teksti, joka on valittu kun `Enter`-näppäintä painetaan tai hyväksytään kyseinen kohta.
172	174
173	175		AutoSelected
174	176
175	177		True osoittaa, että Edit tai ComboBox komponentti on juuri suorittanut AutoSelect toiminnan siten, että myöhemmät hiirellä ja näppäimistön syöttö jatkuu normaalisti valitsematta tekstiä.
176	178
177	179		BorderSpacing
178	180
179	181		Ankkuroidun komponentin ja sen vanhemman välisen ympäröivän reunan etäisyys.
180	182
181	183		Caption
182	184
183	185		Teksti, joka näkyy tai on lähellä komponenttia; Ohjelman käyttäjälle tulee antaa vihjeen siitä, minkä tehtävän tai käskyn komponentti tekee kuten "Sulje" tai "Suorita". Oletuksena Caption-teksti asetetaan samaksi kuin mitä on "Name" ominaisuudessa ja ohjelmoijan pitäisi oletusarvon sijaan korvata se sopivalla tekstillä.
184	186
185	187		CharCase
186	188
187	189		Kertoo, miten teksti näkyy tekstin muokkauskomponentissa: Normaali (sellaisenaan, säilyttäen käyttäjän antaman syötteen), muunnetaan isoiksi tai pieniksi kirjaimiksi.
188	190
189	191		Constraints
190	192
191	193		Asettaa äärikoot komponentille. Jos kokoa muutetaan niin uudet ulottuvuudet ovat aina vaihteluvälien rajoissa. Ohjelmoikan tulisi huolehtia asettaessaan näitä, että ne eivät ole ristiriidassa Anchors ja Align asetuksien kanssa.
192	194
193	195		Color
194	196
195	197		Väri jota käytetään piirtämään komponentti ja sen näyttämää kirjoitettavaa tekstiä.
196	198
197	199		Enabled
198	200
199	201		Boolean ominaisuus joka määrittää, onko komponentti valittavissa, käytössä tai voiko se suorittaa toiminnon. Jos se ei ole käytössä (arvossa false) niin se on usein harmaana lomakkeella.
200	202
201	203		Font
202	204
203	205		Kirjaisin jota käytetään kirjoitettaessa tekstiä komponenttiin liittyen - joko caption, label tai teksti komponentin sisällä . Komponenttimuokkaimessa on nuoli-merkintä yleensä tämän kohdan vasemmalla puolen, ja valitsemalla se niin se paljastaa muita vaihtoehtoja kuten merkistön, värin ja koon.
204	206
205	207		Height
206	208
207	209		Komponentin korkeus. Katso myös Width.
208	210
209	211		Hint
210	212
211	213		Lyhyt informatiivinen vihjeteksti joka näkyy ponnahdustekstinä, jos hiiren kursori menee komponentin päälle. Katso myös ShowHint ominaisuus.
212	214
213	215		Items
214	216
215	217		Luettelo "asioista", jota kohde sisältää, kuten joukko kuvia, luettelo tekstiä, toimintoja käytettäessä actionlist:aa jne.
216	218
217	219		Left
218	220
219	221		Määrittää missä komponentti sijaitsee suhteessa vanhempaan (lomake, ikkuna) vaakasuunta. Katso myös Top
220	222
221	223		Lines
222	224
223	225		Merkkijonojen joukko, joka sisältää tekstisisältöä enemmän kuin yhden rivin tietoja. Taulukko on nolla-indeksoitu eli rivit on numeroitu (alkaen nollasta)\[0..numLines-1\]
224	226
225	227		Name
226	228
227	229		Tunniste eli nimi, jonka avulla komponentti tunnetaan ohjelmassa. Kehitysympäristö antaa sille oletuksena nimen joka pohjautuu taustalla tyypin mukaan, esimerkiksi peräkkäisinä esiintyvät TBitButton-komponentit olisivat nimeltään BitButton1 ja BitButton2; Olisi hyvä jos ohjelmoija antaisi näille enemmän kuvaavampia nimiä kuten ExitButton tai OKButton. Oletuksena komponentin nimi viedään myös Caption tekstiksi, mutta Caption teksti voidaan muuttaa erikseen.
228	230
229	231		PopUpMenu
230	232
231	233		Ikkuna joka sisältää tilannekohtainen valikkotietoa, joka avautuu, kun hiiren oikealla painikkeella klikataan komponenttia.
232	234
233	235		ReadOnly
234	236
235	237		Boolean omonaisuus, ja jos sen arvo on true, niin tarkoittaa sitä että käyttäjä tai kutsuva rutiini voi luke komponentin sisältö, mutta se ei voi kirjoittaa siihen tai muuttaa sitä.
236	238
237	239		ShowHint
238	240
239	241		Sallii pienen tekstikentän, joka sisältää tilannekohtaisen ohjeen tai muun kuvauksen, joka näkyy, kun hiiren kursori on komponentin "päällä". Katso Hint-ominaisuutta.
240	242
241	243		Style
242	244
243	245		Valittavissa olevia tyylivaihtoehtoja: esimerkiksi Style voidaan määrittää TFormStyle, TBorderStyle, TButtonStyle jne.
244	246
245	247		TabOrder
246	248
247	249		Kokonaisluku määritellään missä järjestyksessä `Tab` -näppäin käy läpi lomaketta.
248	250
249	251		TabStop
250	252
251	253		Boolean ominaisuus jos True niin paikka johon käyttäjä voi päästä peräkkäin painamalla `Tab` eli sarkainnäppäintä.
252	254
253	255		Text
254	256
255	257		Merkkijono teksti, joka edustaa todellisia tietoja, mitä tämä komponentti sisältää. Koskee erityisesti Text, Memo ja StringList tyyppisiä komponentteja. Suurin osa editointi (kuten Select, Clear, Cut, Copy) suoritetaan komponentin tässä osassa, joka sisältää todellisen muokattavan merkkijonon. Jos komponentissa on enemmän kuin yksi rivi tekstiä, esimerkiksi TMemo tai TComboBox, niin tekstielementtejä on järjestetty merkkijonojoukoiksi (nolla-indeksoitu eli numeroituna \[0..rivien määrä-1\]) rivejä.
256	258
257	259		Top
258	260
259	261		Määrittää missä komponentti sijaitsee suhteessa vanhempaan (lomake, ikkuna) pystysuunta. Katso myös Left
260	262
261	263		Visible
262	264
263	265		Jos ominaisuuden arvo on true niin komponentti näkyy lomakkeella. Jos arvo on false niin komponentti on piilotettu.
264	266
265	267		Width
266	268
267	269		Komponentin leveys. Katso myös Height.
268	270
269	271		WordWrap
270	272
271	273		Looginen lippu osoittaa, onko automaattinen rivinvaihto on käytössä, eli jos sana tulee lähelle rivin loppuun ja tulee olemaan liian pitkä rivi niin osa siitä on siiretty (alaspäin) seuraavalle riville.
272	274
273	275		#### Tapahtumat
274	276
275	277		Monet tapahtumat ovat yleisesti lueteltu "Tapahtumat" välilehdellä komponenttimuokkaimessa. Jos komponenttimuokkaimessa valitaan tapahtuman viereinen tyhjäkenttä kenttä niin siihen muodostuu ComboBox jonka alasvetoluettelosta näkyy luettelo kaikista toimista jotka on jo määritelty. Tämän avulla voidaan valita tähän tapahtumaan yhden kohdan. Vaihtoehtoisesti voit valita kolme pistettä `...`-painike jolloin lähdekoodieditorissa tehdään metodin sisään alue johon voidaan aloittaa kirjoittamaan oman toiminnan käskyjä valittuun tapahtumaan.
276	278
277	279		Vaikka suuri määrä tapahtumia on liitettävissä komponentin toimintaan. Käytännössä se on tarpeen vain asettaa muutamaan niistä. Useimmille komponenteille on riittävää koodaata onClick-tapahtuma; monimutkaisemmissa komponenteissa voi olla tarpeen myös kirjoittaa toiminta tapahtumiin "OnEntry" (kun hiiren osoitin siirtyy komponentille ja se valitaan) ja "OnExit" (kun hiiren osoitin poistuu komponentilta), tai ehkä kirjoittaa tapahtumankäsittelijä "OnChange" tai "OnScroll" -tapahtumiin, riippuen komponenteista, jonka kanssa ollaan tekemisissä.
278	280
279	281		Pop-up-valikko, joka tulee näkyviin hiiren oikealla painikkeella kun komponenttia klikataan lomakkeella. Siinä ensimmäisenä vaihtoehtona on: "Luo oletustapahtuma". Valitsemalla tämän vaihtoehdon on sillä sama vaikutus kuin valitsemalla kolme pistettä komponenttimuokkaimen oletuksena olevassa tapahtumassa joka on yleensä "onClick". Eli lähdekoodieditorissa tehdään metodin sisään alue johon voidaan aloittaa kirjoittamaan oman toiminnan käskyjä.
280	282
281	283		Yleinen strategia Olio-ohjelmoinnissa on tarjota [[TActionList\|ActionList]] johon on tehty useita ennalta määriteltyjä toimenpiteitä, joista sopivin voidaan valita käyttöön siinä tapauksessa.
282	284
283		-	~~Joitakin yleisiä tapahtumia~~
	285	+	```text
	286	+	<caption><b>Joitakin yleisiä tapahtumia</b></caption>
	287	+	```
284	288
285	289		Tapahtuma
286	290
287	291		Merkitys
288	292
289	293		OnChange
290	294
291	295		Tapahtuu jos jokin muutos havaitaan (esim hiiren liikkua, hiiren klikkaus, näppäimen painallus, tekstin muokkaus, kuva muuttuu jne)
292	296
293	297		OnClick
294	298
295	299		Tapahtuu kun (ensimmäinen, yleensä vasenta) hiiren painiketta klikataan. Tämä on yleensä pää- tai oletus toiminto; esimerkiksi kun klikataan painiketta tai muuta vastaavaa.
296	300
297	301		Click
298	302
299	303		Menetelmä matkia koodina klikkaamisen vaikutusta. Tämä menetelmä on useimmiten löytyy Button-tyyppisistä komponenteista (TButton, TBitBtn, TSpeedButton jne). Aliohjelma voidaan kirjoittaa niin että kutsutaan samaa koodia kuin onClick toiminta. Tämä järjestely voi olla erityisen hyödyllistä, jos yhden komponentin aktivointi klikkaamalla aiheuttaa lukuisiin muiden komponenttien aktivointia, ja valitsemalla menetelmä voidaan käyttää aloittamaan toiminto sen sijaan, käyttäjä joutuu klikkaamaan monia komponentteja.
300	304
301	305		OnDragDrop
302	306
303	307		Toteuttaa toimet vedä ja pudota (Drag-Drop) liikkeen aikana, eli kun hiirtä käytetään "kaappaamaan" kohteen tai jotain tekstiä jne ja siirtää sen uuteen paikkaan.
304	308
305	309		OnEditingDone
306	310
307	311		Toiminta alkaa kun käyttäjä on lopettanut kaikki muutokset / muutokset komponenttiin. Tätä käytetään usein tarkistamaan komponentin sisältöä (esim. tarkistamaan että syötetty teksti on oikea tai kunnollinen IP-osoite)
308	312
309	313		OnEntry
310	314
311	315		Toteuttaa toimet kun hiiren osoitin siirtyy komponentille tai yleisesti kun "painopiste" siirtyy komponenttiin. Tämä saattaa sisältää muutoksia komponentin ulkonäköön kuten korostamaan sitä tai kohottamaan sen reunuksia.
312	316
313	317		OnExit
314	318
315	319		Tapahtuma aktivoituu, kun hiiri siirtyy pois komponentin alueelta, yleisesti siirtämällä "painopiste" pois komponentilta.
316	320
317	321		OnKeyPress
318	322
319	323		Tapahtuma aktivoituu, kun painetaan jotain näppäintä. Hienovaraisesti erilainen kuin OnKeyDown, joka yksinkertaisesti aktivoituu näppäimen ollessa alhaalla. OnKeyPress vaatii, että painopiste on jo tässä komponentissa kun näppäintä painetaan.
320	324
321	325		OnKeyDown
322	326
323	327		Tapahtuma aktivoituu, jos näppäin on alhaalla, kun "painopiste" (fokus) on tässä komponentissa. Hienovaraisesti erilainen kuin OnKeyPress - esimerkiksi näppäin saattaa olla jo alhaalla, kun focus tuli tähän komponenttiin, kun taas OnKeyPress vaatii näppäintä painetaan vasta kun painopiste on tässä komponentissa.
324	328
325	329		OnKeyUp
326	330
327	331		Tapahtuma aktivoituu kun näppäin "vapautetaan" eli nousee ylös (tai näppäimen painaminen loppuu) kun focus on tässä komponentissa.
328	332
329	333		OnMouseMove
330	334
331	335		Tapahtuma aktivoituu kun hiiren osoitin liikkuu ja focus on tässä komponentissa.
332	336
333	337		OnMouseDown
334	338
335	339		Tapahtuma aktivoituu kun hiiren näppäin menee alas ja focus on tässä komponentissa.
336	340
337	341		OnMouseUp
338	342
339	343		Tapahtuma aktivoituu kun hiiren näppäin "vapautetaan" ja focus on tässä komponentissa. Eli hiiren näppäin on jo aikaisemmin painettu alas ja painaminen lopetetaan/päätetään
340	344
341	345		OnMouseEnter
342	346
343	347		Tapahtuma aktivoituu kun hiiren osoitin siirtyy komponentille ( mutta hiiren painiketta ei vielä ole painettu) .
344	348
345	349		OnResize
346	350
347	351		Tapahtuma aktivoituu kun komponentin kokoa muutetaan tai koko muuttuu. Voi aktivoitua esim. kun teksti tasataan toiseen reunaan, keskitetään tai valitaan eri fonttikokoa jne.
348	352
349	353		#### Rakentajat & purkajat
350	354
351	355		Nämä ovat kaksi erityistä metodia liittyvät [[Class\|luokkiin]](komponentit):
352	356
353	357		- [[Constructor/fi\|Constructor (Rakentaja)]]: kuten Create varaa olion (komponentin) tarvitsemaa muistia ja järjestelmäresursseja. Ne tarpeen vaatiessa kutsuvat myös muita luokan aliolioiden rakentajia.
354	358
355	359		- [[Destructor/fi\|Destructor (purkaja)]]: poistaa olion ja vapauttaa varatun muistin sekä muita resursseja. Jos kutsut Destroy (tuhoa) olio, jota ei ole vielä alustettu,niin se aiheuttaa virheen. Käytä aina Free metodia puratessa olioita, koska se tarkistaa, onko olion arvo on [[Nil/fi\|nil]] ennenkuin kutsuu Destroy metodia.
356	360
357	361		Noudata seuraavia varotoimia, kun luoda oman Destroy metodin:
358	362
359	363		- Määritä Destroy override directive:llä, koska se on virtual metodi.
360	364		- Kutsu aina 'inherited Destroy;' viimeisenä asiana destructor:in koodissa.
361	365		- Huomaa, että [[Exceptions/fi\|exception (poikkeus)]] voidaan nostaa jos constructor (rakentajalla) ei ole tarpeeksi muistia luoda olio tai jotain muuta menee pieleen. Jos poikkeusta ei käsitellä rakentajan sisällä, olio on tällöin vain osittain rakennettu. Tässä tapauksessa kun Destroyta kutsutaan, destructor:in täytyy tarkistaa että resurssit olivat todella varattu ennen kuin se hävittää ne.
362	366		- Muista kutsua Free metodia kaikille olioille jotka on luotu constructor:lla.
363	367
364	368		## Kuinka käyttää valikko-komponenttia
365	369
366	370		Vihjeitä miten luoda valikot lomakkeelle.
367	371
368	372		[[TMainMenu/fi\|TMainMenu]] ![](/wiki-images/6/6f/Tmainmenu.png) on päävalikko, joka näkyy monen lomakkeen yläosassa; Lomakkeen suunnittelija voivat muokata sitä valitsemalla eri valikkovaihtoehtoja. [[TPopupMenu/fi\|TPopupMenu]] ![](/wiki-images/e/e4/Tpopupmenu.png) on valikko -ponnahdusikkunassa, jossa on yleensä tilannekohtaisia, yksityiskohtia vaihtoehtoja. Se "ponnahtaa" kun hiiren oikeaa näppäintä klikataan lähellä komponenttia.
369	373
370	374		Päävalikko on ei-näkyvä komponentti: toisin sanoen jos kuvake on valittu komponenttipaletilta ja saatetaan lomakkeelle niin se ei näy ohjelman [[runtime/fi\|ajon aikana]]. Sen sijaan, valikkorivi jonka rakenne määritellään valikkomuokkaimessa ilmestyy. Ponnahdusvalikot (saattaa lomakkeelle valitsemalla kyseinen kuvake komponentipaletilta) eivät näy ollenkaan kunnes hiiren oikealla painikkeella klikataan komponenttia, jolla on tällainen valikko.
371	375
372	376		Nähdäksesi valikkomuokkaimen, klikkaa hiiren oikealla Main Menu tai Popup Menu -kuvaketta lomakkeella. Tällöin avautuu ikkuna johon voidaan syöttää valikon kohteet.
373	377
374	378		valikkomuokkaimessa näkyy laatikko joka sisältää painikkeen "New Item1". Jos klikkaa hiiren oikealla kyseistä painiketta, pop-up-valikko tulee näkyviin, jonka avulla voit lisätä uuden kohdan ennen tai jälkeen (samalla tasolla) tai luoda alivalikon mahdollisuuden johon lisätä uusia kohteita sen alle.
375	379
376	380		Mikä tahansa MenuItems joka lisätään voidaan määrittää käyttämällä komponenttimuokkainta.
377	381
378	382		Ainakin kullekin kohdalle pitäisi antaa Caption-teksti , joka näkyy valikkorivillä. sen tulisi kertoa toimintaa jota voidaan valita, kuten "Avaa tiedosto", "Sulje", "Suorita" tai "Lopeta". Voidaan myös haluta antaa tätä merkityksellisempi nimi.
379	383
380	384		Jos halutaan tietyn Caption-tekstni kirjaimen liittyvän pikanäppäin-toimintoon, niin kirjain pitäisi edeltää et-merkillä (&). Jolloin ohjelman ajon aikana valikkokohtaan ilmestyy pikanäppäintä vastaava kirjain alleviivattuna ja painamalla kirjainta vastaavaa näppäintä on sillä sama vaikutus kuin valitsemalla valikosta. Vaihtoehtoisesti voidaan pikanäppäin sekvenssit (esimerkiksi `Ctrl`+`C` kopioi tai `Ctrl`+`V` liitä - standardin mukaiset pikanäppäimet) valita MenuItem:n ShortCut ominaisuuteen.
381	385
382	386		Usein on hyödyllistä käyttää valikoiden yhteydessä [[TActionList]] komponenttia joka sisältää joukon standardin mukaisia tai räätälöityjä tapahtumia. Valikkokohdat voidaan linkittää komponenttimuokkaimessa lueteltuihin tapahtumiin ja samoja tapahtumia voidaan yhdistää painikkeisiin, työkalupalkin painikkeihin, pikapainikkeisiin jne. On tietenkin tehokkaampaa käyttää uudelleen samaa koodia vastata erilaisiin tapahtumiin, kuin kirjoittaa erillinen OnClick tapahtumakäsittelijä jokaiseen yksittäiseen komponenttiin.
383	387
384	388		Oletuksena useita standarditapahtumia ovat valmiiksi ladattu. Nämä tapahtumat voidaan valita käyttämällä toimintolistan muokkainta joka näkyy, kun hiiren klikkaa ActionList kuvaketta lomakkeella.
385	389
386	390		## Virheenjäljitys
387	391
388	392
389	393		Jotain kirjoitettu toisaalla.
390	394
391	395		1\) Varmista, että olet lukenut sen asetukset: [[Debugger Setup]]
392	396
393	397		2\) Katso myös [:category: IDE Window - Debug](/wiki-category/IDE%20Window%20-%20Debug)
394	398
395	399		3\) Lue rajoitukset: [[GDB Debugger Tips\|GDB_Debugger_Tips#Inspecting_data_types_.28Watch.2FHint.29]] Tämä sivu antaa ohjeita myös joidenkin alustoiden / versioiden erityiskysymyksiln
396	400
397	401		## Lazarus tiedostot
398	402
399		-	~~` (Kiitokset: Kevin Whitefoot.)`\~~
400		-	~~` (Lisäykset: Giuseppe Ridinò, `User:Kirkpatc` ja Tom Lisjac)`~~
	403	+	```text
	404	+	(Kiitokset: Kevin Whitefoot.)
	405	+	(Lisäykset: Giuseppe Ridinò, User:Kirkpatc ja Tom Lisjac)
	406	+	```
401	407
402	408		Kun tallennat niin tallennat kahden nimisiä tiedostoja:
403	409
404		-	~~` xxx.pas ja yyy.lpr `~~
	410	+	```text
	411	+	xxx.pas ja yyy.lpr
	412	+	```
405	413
406	414		(Todellisuudessa tallennetaan enemmän mutta niillä on sama nimi mutta eri pääte). Projektitiedoston (lpr) ja käännösyksikön tiedoston (pas) nimi ei saa olla sama. Tietenkin on johdonmukaista muuttaa kaikki esiintymät Unit1 kuuvaavimmiksi nimiksi.
407	415
408	416		Joten jos tallennat projektin nimeltä again, yrittää tallentaa again.pas ja again.lpr epäonnistuu, koska yksiköiden nimet ja ohjelmien nimet ovat samassa nimiavaruudessa ja on tuloksena kehitysympäristö kertoo että on olemassa samanniminen tiedosto.
409	417
410	418		Joten tähän päädyttiin:
411	419
412	420		e:/lazarus/kj/lazhello:
413	421
414		-	~~`total 4740 free 76500`\~~
415		-	~~`-rwxrwxrwx 1 kjwh root 4618697 Mar 24 11:19 again.exe`\~~
416		-	~~`-rw-rw-rw- 1 kjwh root 3002 Mar 24 11:21 again.lpi`\~~
417		-	~~`-rw-rw-rw- 1 kjwh root 190 Mar 24 11:18 again.lpr`\~~
418		-	~~`-rw-rw-rw- 1 kjwh root 506 Mar 24 11:08 againu.lfm`\~~
419		-	~~`-rw-rw-rw- 1 kjwh root 679 Mar 24 11:08 again.res`\~~
420		-	~~`-rw-rw-rw- 1 kjwh root 677 Mar 24 11:08 againu.pas`\~~
421		-	~~`-rw-rw-rw- 1 kjwh root 2124 Mar 24 11:08 againu.ppu`\~~
422		-	~~`-rwxrwxrwx 1 kjwh root 335 Mar 24 11:07 ppas.bat`~~
	422	+	```text
	423	+	total 4740 free 76500
	424	+	-rwxrwxrwx 1 kjwh root 4618697 Mar 24 11:19 again.exe
	425	+	-rw-rw-rw- 1 kjwh root 3002 Mar 24 11:21 again.lpi
	426	+	-rw-rw-rw- 1 kjwh root 190 Mar 24 11:18 again.lpr
	427	+	-rw-rw-rw- 1 kjwh root 506 Mar 24 11:08 againu.lfm
	428	+	-rw-rw-rw- 1 kjwh root 679 Mar 24 11:08 again.res
	429	+	-rw-rw-rw- 1 kjwh root 677 Mar 24 11:08 againu.pas
	430	+	-rw-rw-rw- 1 kjwh root 2124 Mar 24 11:08 againu.ppu
	431	+	-rwxrwxrwx 1 kjwh root 335 Mar 24 11:07 ppas.bat
	432	+	```
423	433
424	434		Huomaa, että on olemassa paljon enemmän tiedostoja kuin ne kaksi, jotka aluksi mainittiin.
425	435
426	436		again.exe: Pääohjelma joka on ajettavissa. MS windows:ssa lisätään "exe" tiedostopäätelaajennus. Linux:ssa ei lisätä mitään (vain ohjelman nimi). Tämä tiedosto on oletuksena paljon tilaa vievä johtuen sen sisällyttämistä virheenkorjaus symboleista. Kokoa voi pienentää muuttamalla kehitysympäristön asetuksia tai/ja ajamalla "strip" apuohjelma joka poistaa niitä ja merkittävästi pienentää ajettavan tiedoston kokoa.
427	437
428	438		again.lpi: (Lazarus Project Information). Tämä on tärkein informaatio tiedosto Lazarus projektilla; Delphissä sitä vastaavat tärkeimmät tiedot on .dpr tiedostossa. Se on tallennettu XML-muodossa ja sisältää ohjeet kaikista kirjastoista ja tarvittavista käännösyksiköistä kun rakennetaan suoritettavaa tiedostoa.
429	439
430	440		again.lpr: Pääohjelma lähdekooditiedostona. Huolimatta erityisestä tiedostopääte tarkenteesta niin se on itse asiassa täysin normaalia Pascal lähdekooditiedosto. Siinä on uses lauseke, jonka avulla kääntäjä löytää kaikki käännösyksiköt joita se tarvitsee. Huomaa, että program toteamus ei tarvitse nimetä ohjelmaa samaksi kuin tiedoston nimi. Tämä tiedosto on yleensä melko pieni, vain muutaman lausekkeita alustamiseksi, rakentaa lomakkeet, ajaa ja sulkea sovelluksen. Suurin osa työstä tehdään käännösyksiköiden lähdekooditiedostoissa, jossa on tiedostopääte ".pas"
431	441
432	442		againu.lfm: Lazarus tallentaa käännösyksikön lomakkeen ulkoasun, ihmisen luettavissa olevassa muodossa. Se kertoo eri komponenttien, ominaisuuksia jotka on asetettu komponenttimuokkaimella. Jokaisen komponentin kuvaus alkaa rivillä:
433	443
434		-	~~`object xxxx `\~~
435		-	~~` sitten seuraa ominaisuuksien luettelo `\~~
436		-	~~` (Myös upotettuja tai sisäkkäisiä objekteja) sitten `\~~
437		-	~~`end `\~~
438		-	~~`rivi.`~~
	444	+	``` pascal
	445	+	object xxxx
	446	+	sitten seuraa ominaisuuksien luettelo
	447	+	(Myös upotettuja tai sisäkkäisiä objekteja) sitten
	448	+	end
	449	+	rivi.
	450	+	```
439	451
440	452		Lazarus käyttää tätä tiedostoa kun luo resurssitiedoston (.res). Delphi DFM tiedostot voidaan muuntaa lfm muotoon Lazarus kehitysympäristössä käyttäen: Työkalut -\> Delphi muunnos -\> Muunna binaarinen DFM-tiedosto teksti LFM:ksi ja tarkista syntaksi.
441	453
442	454		again.res: Tämä on luotu resurssi tiedosto, joka sisältää ohjeet ohjelman rakentamiseen (jos tarkastellaan pääohjelma tiedostoa, näette alustuksen osassa rivin
443	455
444	456		``` pascal
445	457		{$i *.res}
446	458		```
447	459
448	460		joka ohjaa ohjelman lataamaan resurssitiedoston). Huomaa, että se ei ole Windows resurssi-tiedosto.
449	461
450	462		againu.pas: Käännösyksikkö, joka voi sisältää myös lomakkeen koodin; tämä on yleensä vain tiedosto jota ohjelmoijan tarvitsee muokata tai tarkastaa, ja se nimenomaisesti sisältää ohjelmoijan toimittamaa koodia (erityisesti tapahtuman käsittelijät).
451	463
452	464		againu.ppu: Tämä on koottu käännöyksikkö, joka linkitetään suoritettavaan tiedostoon yhdessä muiden käännösyksiköiden jotka on nimetty Uses osiossa.
453	465
454	466		ppas.bat: Tämä on yksinkertainen skripti, joka yhdistää ohjelman tuottaman suoritettavan tiedoston. Jos käännös on onnistunut, kääntäjä poistaa sen.
455	467
456	468		## Katso myös
457	469
458	470		- [[Lazarus IDE Tools/fi\|Lazarus IDE Tools]]
459	471		- [[Lazarus project files]]
460	472
461	473		---
462	474		From the Free Pascal wiki, page "Lazarus Tutorial/fi", as it stood on 2021-12-08 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history