← Back to branch summary

~ubuntu-branches/ubuntu/precise/zenity/precise-updates

« back to all changes in this revision

Viewing changes to help/fi/zenity.xml

  • Committer: Package Import Robot
  • Author(s): Robert Ancell
  • Date: 2012-03-29 14:50:15 UTC
  • mfrom: (1.1.45)
  • Revision ID: package-import@ubuntu.com-20120329145015-p6jkb44cf19r2qyi
Tags: 3.4.0-0ubuntu1
* New upstream release:
  - Add support for lists and trees with --forms
  - Fix warning reading list from stdin
* debian/zenity-common.install:
  - Doesn't install omf files anymore

Show diffs side-by-side

added added

removed removed

Lines of Context:
help/fi/zenity.xml
1
 
<?xml version="1.0" encoding="utf-8"?>
2
 
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
3
 
<!ENTITY author1 "Sun">
4
 
<!ENTITY author2 "Java Desktop System Documentation Team">
5
 
<!ENTITY publisher "Sun Microsystems, Inc.">
6
 
<!ENTITY legal SYSTEM "legal.xml">
7
 
<!ENTITY appversion "2.6.0">
8
 
<!ENTITY app "<application>Zenity</application>">
9
 
<!ENTITY appname "Zenity">
10
 
<!ENTITY date "August 2004">
11
 
<!ENTITY manrevision "2.0">
12
 
]>
13
 
<!-- ================ Document Header ================= -->
14
 
<article id="index" lang="fi">
15
 
 
16
 
  <articleinfo>
17
 
    <title>Zenityn ohje</title>
18
 
    <subtitle>Zenity-työpöytäsovelluksen ohje v2.0</subtitle>
19
 
    <copyright>
20
 
            <year>2003</year>
21
 
            <year>2004</year>
22
 
            <holder>Sun Microsystems, Inc.</holder>
23
 
    </copyright><copyright><year>2008.</year><holder>Tommi Vainikainen (thv@iki.fi)</holder></copyright>
24
 
 
25
 
    <!-- Translators: uncomment this
26
 
    <copyright>
27
 
            <year>2004</year>
28
 
            <holder>ME_THE_TRANSLATOR</holder>
29
 
    </copyright>
30
 
    -->
31
 
 
32
 
    <publisher>
33
 
            <publishername>Sun Microsystems, Inc.</publishername>
34
 
    </publisher>
35
 
 
36
 
      <legalnotice id="legalnotice">
37
 
        <para>Tätä asiakirjaa saa kopioida, jakaa edelleen ja/tai muokata Free Software Foundationin julkaiseman GNU Free Documentation Licensen (GFDL) version 1.1 tai valinnaisesti myöhemmän version mukaisesti, ilman vaatimuksia muuttamattomista osioista ja etu- tai takakansiteksteistä. Kopion GFDL:stä voi nähdä napsauttamalla <ulink type="help" url="ghelp:fdl">tätä linkkiä</ulink>, tai lukemalla ohjeen mukana toimitetun COPYING-DOCS-nimisen tiedoston.</para>
38
 
         <para>Tämä käyttöohje on osa Gnomen käyttöohjekokoelmaa, jota levitetään GFDL-lisenssin alaisena. Jos haluat levittää tätä käyttöohjetta erillään kokoelmasta, voit tehdä sen liittämällä lisenssin kopion ohjeen mukaan, kuten lisenssin luku 6 sanelee.</para>
39
 
 
40
 
        <para>Monet nimistä, joita yhtiöt käyttävät tuotteistansa ja palveluistansa, ovat tuotemerkkejä. Gnomen dokumentointiprojektissa nämä nimet pyritään kirjoittamaan suuraakkosin tai isolla alkukirjaimella, sikäli kun projektin jäsenet tietävät kyseisistä tuotemerkeistä.</para>
41
 
 
42
 
        <para>ASIAKIRJA JA SEN MUOKATUT VERSIOT TARJOTAAN GNU FREE DOCUMENTATION LICENSEN EHTOJEN MUKAISESTI YMMÄRTÄEN ETTÄ: <orderedlist>
43
 
                <listitem>
44
 
                  <para>ASIAKIRJA TARJOTAAN "SELLAISENAAN", ILMAN MINKÄÄN LAISTA TAKUUTA, NIIN ILMAISTUA KUIN IMPLISIITTISTÄ, SISÄLTÄEN ILMAN RAJOITUKSIA TAKUUTA SIITÄ, ETTÄ ASIAKIRJA TAI SEN MUOKATTU VERSIO OLISI ILMAN VIRHEITÄ, MYYNTIKELPOINEN, SOVELTUVAT JOHONKIN TARKOITUKSEEN TAI EI-LOUKKAAVA. TÄYSI RISKI ASIAKIRJAN TAI SEN MUOKATUN VERSION LAADUSTA, TARKKUUDESTA TAI HYÖDYLLISYYDESTÄ ON SINULLA. MIKÄLI ASIAKIRJA TAI SEN MUOKATTU VERSIO OSOITTAUTUU VIALLISEKSI MISSÄÄN MIELESSÄ, SINÄ (EI ALKUPERÄINEN KIRJOITTAJA, TEKIJÄ TAI MUU MYÖTÄVAIKUTTAJA) VASTAAT KAIKKIEN TARPEELLISTEN PALVELUIDEN, KORJAUSTEN TAI OIKAISUJEN KULUISTA. TÄMÄ VASTUUVAPAUSLAUSEKE MUODOSTAA OLEELLISEN OSAN TÄSTÄ LISENSSISTÄ. MIHINKÄÄN ASIAKIRJAN TAI SEN MUOKATUN VERSION KÄYTTÖÖN EI OLE MYÖNNETTY LUPAA TÄSSÄ PAITSI TÄMÄN VASTUUVAPAUSLAUSEKKEEN MUKAISESTI; JA</para>
45
 
                </listitem>
46
 
                <listitem>
47
 
                  <para>EI MISSÄÄN OLOSUHTEISSA TAI MINKÄÄN LAKITEORIAN ALAISUUDESSA, OIKEUDENLOUKKAUKSEN (SISÄLTÄEN HUOLIMATTOMUUDEN), SOPIMUKSEN TAI MUUTOIN, ASIAKIRJAN TAI SEN MUOKATUN VERSION ALKUPERÄISTÄ KIRJOITTAJAA, KETÄÄN MYÖTÄVAIKUTTAJAA TAI KETÄÄN JAKELIJAA, TAI KETÄÄN MINKÄÄN NÄISTÄ OSAPUOLISTA TOIMITTAJAA, OLE VASTUUSSA KENELLEKÄÄN HENKILÖLLE MISTÄÄN SUORASTA, EPÄSUORASTA, ERITYISESTÄ, VÄLITTÖMISTÄ TAI VÄLILLISISTÄ MINKÄÄN SORTIN VAHINGOISTA SISÄLTÄEN ILMAN RAJOITUSTA VAHINGOT MAINEEN MENETYKSESTÄ, TYÖN SEISAUKSISTA, TIETOKONEVAHINGOISTA TAI -VIRHEISTÄ, TAI MISTÄÄN  MUUSTAKAAN VAHINGOSTA TAI TAPPIOISTA, JOTKA LIITTYVÄT ASIAKIRJAN JA SEN MUOKATTUJEN VERSIOIDEN KÄYTTÖÖN, EI EDES SILLOIN KUN OSAPUOLELLE ON KERROTTU TÄLLAISTEN VAHINKOJEN MAHDOLLISUUDESTA.</para>
48
 
                </listitem>
49
 
          </orderedlist></para>
50
 
  </legalnotice>
51
 
 
52
 
 
53
 
 
54
 
    <authorgroup>
55
 
      <author>
56
 
        <firstname>Sun</firstname>
57
 
        <surname>Java-työpöytäjärjestelmän dokumentointiryhmä</surname>
58
 
        <affiliation><orgname>Sun Microsystems, Inc.</orgname></affiliation>
59
 
      </author>
60
 
      <author role="maintainer">
61
 
        <firstname>Glynn</firstname>
62
 
        <surname>Foster</surname>
63
 
        <affiliation>
64
 
          <orgname>GNOME-dokumentointiprojekti</orgname>
65
 
        </affiliation>
66
 
      </author>
67
 
      <editor>
68
 
        <firstname>Nicholas</firstname>
69
 
        <surname>Curran</surname>
70
 
        <affiliation>
71
 
          <orgname>GNOME-dokumentointiprojekti</orgname>
72
 
        </affiliation>
73
 
      </editor>
74
 
    </authorgroup>
75
 
 
76
 
    <revhistory>
77
 
      <revision>
78
 
        <revnumber>Zenity-työpöytäsovelluksen ohje v2.0</revnumber>
79
 
        <date>Elokuu 2004</date>
80
 
        <revdescription>
81
 
          <para role="author">Sun Java -työpöytäjärjestelmän dokumentointiryhmä</para>
82
 
          <para role="publisher">Sun Microsystems, Inc.</para>
83
 
        </revdescription>
84
 
      </revision>
85
 
 
86
 
      <revision>
87
 
        <revnumber>Zenityn ohje v1.0</revnumber>
88
 
        <date>Tammikuu 2003</date>
89
 
        <revdescription>
90
 
          <para role="author">Glynn Foster</para>
91
 
          <para role="publisher">GNOME-dokumentointiprojekti</para>
92
 
        </revdescription>
93
 
      </revision>
94
 
    </revhistory>
95
 
 
96
 
    <releaseinfo>Tämä ohjekirja kuvaa Zenityn versiota 2.6.0.</releaseinfo>
97
 
 
98
 
    <legalnotice>
99
 
            <title>Palaute</title>
100
 
            <para>Palautetta voi lähettää seuraamalla ohjeita <ulink url="ghelp:gnome-feedback" type="help">palautesivulla</ulink>.</para>
101
 
<!-- Translators may also add here feedback address for translations -->
102
 
 
103
 
    </legalnotice>
104
 
    <abstract role="description">
105
 
            <para>Zenity on uudelleenkirjoitettu gdialog, GNOME-siirros dialog-ohjelmasta, joka mahdollistaa valintalaatikoiden näyttämisen komentoriviltä ja kuoriskripteistä.</para>
106
 
    </abstract>
107
 
  </articleinfo>
108
 
  
109
 
  <indexterm>
110
 
    <primary>zenity-komento</primary>
111
 
  </indexterm>
112
 
  <indexterm>
113
 
    <primary>valintaikkunan luonti</primary>
114
 
  </indexterm>
115
 
<!-- ================ Document Body ================= -->
116
 
 
117
 
<!-- ==== Introduction ====== -->
118
 
 
119
 
  <sect1 id="zenity-introduction">
120
 
    <title>Johdanto</title>
121
 
 
122
 
    <para><application>Zenity</application> mahdollistaa seuraavan tyyppisten yksinkertaisten ikkunoiden luomisen:</para>
123
 
 
124
 
    <itemizedlist>
125
 
        <listitem><para>Kalenteri</para></listitem>
126
 
        <listitem><para>Tiedoston valinta</para></listitem>
127
 
        <listitem><para>Luettelo</para></listitem>
128
 
        <listitem><para>Ilmoituskuvake</para></listitem>
129
 
        <listitem><para>Viesti</para>
130
 
            <itemizedlist>
131
 
                <listitem><para>Virhe</para></listitem>
132
 
                <listitem><para>Tiedoksi</para></listitem>
133
 
                <listitem><para>Kysymys</para></listitem>
134
 
                <listitem><para>Varoitus</para></listitem>
135
 
            </itemizedlist>
136
 
        </listitem>
137
 
        <listitem><para>Edistyminen</para></listitem>
138
 
        <listitem><para>Tekstisyöte</para></listitem>
139
 
        <listitem><para>Tekstihuomatus</para></listitem>
140
 
    </itemizedlist>
141
 
 
142
 
  </sect1>
143
 
 
144
 
<!-- ==== Usage ====== -->
145
 
 
146
 
  <sect1 id="zenity-usage">
147
 
    <title>Käyttö</title>
148
 
 
149
 
    <para>Skriptejä kirjoitettaessa voi <application>Zenityä</application> käyttää yksinkertaisten valintaikkunoiden luomiseen, jotka pyytävät käyttäjältä syötettä graafisesti, kuten seuraavissa tapauksissa:</para>
150
 
    <itemizedlist>
151
 
      <listitem>
152
 
        <para>Voit luoda valintaikkunan keräämään tietoa käyttäjältä. Voit esimerkiksi pyytää käyttäjää valitsemaan päivän kalenteri-ikkunasta tai valitsemaan tiedoston tiedoston valintaikkunalla.</para>
153
 
      </listitem>
154
 
      <listitem>
155
 
        <para>Voit luoda ikkunan, joka kertoo käyttäjälle tietoa. Voit esimerkiksi näyttää edistymisikkunassa operaation edistymisen tilanteen tai varoitusviesti-ikkunassa varoittaa käyttäjää.</para>
156
 
      </listitem>
157
 
    </itemizedlist>
158
 
    <para>Kun käyttäjä sulkee ikkunan, <application>Zenity</application> tulostaa ikkunaan syötetyn tekstin vakiotulosteeseen.</para>
159
 
 
160
 
    <note>
161
 
      <para>Kun kirjoitat <application>Zenity</application>-komentoja, ole tarkkana lainausmerkkien sijoittelussa jokaisen argumentin ympärillä.</para>
162
 
      <para>Käytä esimerkiksi: <screen><userinput><command>zenity --calendar --title="Loman suunnittelu"</command></userinput></screen> Älä sen sijaan käytä: <screen><userinput><command>zenity --calendar --title=Loman suunnittelu</command></userinput></screen></para>
163
 
      <para>Mikäli et käytä lainausmerkkejä, saatat saada odottamattomia tuloksia.</para>
164
 
    </note>
165
 
 
166
 
    <sect2 id="zenity-usage-mnemonics">
167
 
      <title>Valintanäppäimet</title>
168
 
        <para>Valintanäppäin on näppäin, joka antaa mahdollisuuden suorittaa toiminto näppäimistöltä sen sijaan, että komento valittaisiin hiirellä valikosta tai ikkunasta. Jokainen valintanäppäin identifioidaan alleviivaamalla kirjain valikossa tai ikkunan kohdassa.</para>
169
 
        <para>Jotkut <application>Zenity</application>-ikkunan tukevat valintanäppäinten käyttöä. Määrittääksesi kirjaimen valintanäppäimeksi, anna alaviiva ennen kirjainta ikkunan tekstissä. Seuraava esimerkki valaisee kuinka kirjain "V" määritetään valintanäppäimeksi:</para>
170
 
        <screen><userinput>"_Valitse nimi".</userinput></screen>
171
 
    </sect2>
172
 
 
173
 
    <sect2 id="zenity-usage-exitcodes">
174
 
      <title>Päättymiskoodit</title>
175
 
    <para><application>Zenity</application> palauttaa seuraavia päättymiskoodeja:</para>
176
 
 
177
 
    <informaltable frame="all">
178
 
      <tgroup cols="2" colsep="1" rowsep="1">
179
 
        <colspec colname="COLSPEC0" colwidth="50*"/>
180
 
        <colspec colname="COLSPEC1" colwidth="50*"/>
181
 
        <thead>
182
 
          <row valign="top">
183
 
            <entry colname="COLSPEC0">
184
 
              <para>Päättymiskoodi</para></entry>
185
 
            <entry colname="COLSPEC1">
186
 
              <para>Kuvaus</para></entry>
187
 
          </row>
188
 
        </thead>
189
 
        <tbody>
190
 
          <row valign="top">
191
 
            <entry>
192
 
              <para><varname>0</varname></para>
193
 
            </entry>
194
 
            <entry>
195
 
              <para>Käyttäjä painoi joko <guibutton>OK</guibutton> tai <guibutton>Sulje</guibutton>.</para>
196
 
            </entry>
197
 
          </row>
198
 
          <row valign="top">
199
 
            <entry>
200
 
              <para><varname>1</varname></para>
201
 
            </entry>
202
 
            <entry>
203
 
              <para>Käyttäjä painoi <guibutton>Peru</guibutton> tai käytti ikkunapainikkeita sulkemaan valintaikkunan.</para>
204
 
            </entry>
205
 
          </row>
206
 
          <row valign="top">
207
 
            <entry>
208
 
              <para><varname>-1</varname></para>
209
 
            </entry>
210
 
            <entry>
211
 
              <para>Tapahtui odottamaton virhe.</para>
212
 
            </entry>
213
 
          </row>
214
 
          <row valign="top">
215
 
            <entry>
216
 
              <para><varname>5</varname></para>
217
 
            </entry>
218
 
            <entry>
219
 
              <para>Ikkuna suljettiin aikarajan päätyttyä.</para>
220
 
            </entry>
221
 
          </row>
222
 
        </tbody>
223
 
      </tgroup>
224
 
    </informaltable>
225
 
 
226
 
    </sect2>
227
 
 
228
 
 
229
 
  <!-- ==== General Options ====== -->
230
 
 
231
 
  <sect2 id="zenity-usage-general-options">
232
 
    <title>Yleiset valitsimet</title>
233
 
 
234
 
    <para>Kaikki <application>Zenity</application>-ikkunat tukevat seuraavia yleisiä valitsimia:</para>
235
 
 
236
 
    <variablelist>
237
 
 
238
 
      <varlistentry>
239
 
        <term><option>--title</option>=<replaceable>otsikko</replaceable></term>
240
 
        <listitem>
241
 
          <para>Määrittää ikkunan otsikon.</para>
242
 
        </listitem>
243
 
      </varlistentry>
244
 
 
245
 
      <varlistentry>
246
 
        <term><option>--window-icon</option>=<replaceable>kuvakepolku</replaceable></term>
247
 
        <listitem>
248
 
          <para>Määrittää kuvakkeen, joka näytetään ikkunan kehyksessä. Saatavilla on myös neljä valmista kuvaketta, jotka saa käyttöön seuraavilla avainsanoilla - "info" (tietoa), "warning" (varoitus), "question" (kysymys) ja "error" (virhe).</para>
249
 
        </listitem>
250
 
      </varlistentry>
251
 
 
252
 
      <varlistentry>
253
 
        <term><option>--width</option>=<replaceable>leveys</replaceable></term>
254
 
        <listitem>
255
 
          <para>Määrittää ikkunan leveyden.</para>
256
 
        </listitem>
257
 
      </varlistentry>
258
 
 
259
 
      <varlistentry>
260
 
        <term><option>--height</option>=<replaceable>korkeus</replaceable></term>
261
 
        <listitem>
262
 
          <para>Määrittää ikkunan korkeuden.</para>
263
 
        </listitem>
264
 
      </varlistentry>
265
 
 
266
 
      <varlistentry>
267
 
        <term><option>--timeout</option>=<replaceable>aikaraja</replaceable></term>
268
 
        <listitem>
269
 
          <para>Määrittää aikarajan sekunteina, jonka jälkeen ikkuna suljetaan.</para>
270
 
        </listitem>
271
 
      </varlistentry>
272
 
 
273
 
    </variablelist>
274
 
 
275
 
  </sect2>
276
 
 
277
 
<!-- ==== Miscellaneous Options ====== -->
278
 
 
279
 
  <sect2 id="zenity-help-options">
280
 
    <title>Ohjevalitsimet</title>
281
 
 
282
 
    <para><application>Zenity</application> tarjoaa seuraavat ohjevalitsimet:</para>
283
 
 
284
 
    <variablelist>
285
 
 
286
 
      <varlistentry>
287
 
        <term><option>--help</option></term>
288
 
        <listitem>
289
 
          <para>Näyttää lyhennetyn ohjetekstin.</para>
290
 
        </listitem>
291
 
      </varlistentry>
292
 
 
293
 
      <varlistentry>
294
 
        <term><option>--help-all</option></term>
295
 
        <listitem>
296
 
          <para>Näyttää täyden ohjetekstin kaikista ikkunatyypeistä.</para>
297
 
        </listitem>
298
 
      </varlistentry>
299
 
 
300
 
      <varlistentry>
301
 
        <term><option>--help-general</option></term>
302
 
        <listitem>
303
 
          <para>Näyttää ohjetekstin yleisistä ikkunavalitsimista.</para>
304
 
        </listitem>
305
 
      </varlistentry>
306
 
 
307
 
      <varlistentry>
308
 
        <term><option>--help-calendar</option></term>
309
 
        <listitem>
310
 
          <para>Näyttää ohjetekstin kalenteri-ikkunan valitsimista.</para>
311
 
        </listitem>
312
 
      </varlistentry>
313
 
 
314
 
      <varlistentry>
315
 
        <term><option>--help-entry</option></term>
316
 
        <listitem>
317
 
          <para>Näyttää ohjetekstin tekstisyöttöikkunan valitsimista.</para>
318
 
        </listitem>
319
 
      </varlistentry>
320
 
 
321
 
      <varlistentry>
322
 
        <term><option>--help-error</option></term>
323
 
        <listitem>
324
 
          <para>Näyttää ohjetekstin virheikkunan valitsimista.</para>
325
 
        </listitem>
326
 
      </varlistentry>
327
 
 
328
 
      <varlistentry>
329
 
        <term><option>--help-info</option></term>
330
 
        <listitem>
331
 
          <para>Näyttää ohjetekstin tietoikkunan valitsimista.</para>
332
 
        </listitem>
333
 
      </varlistentry>
334
 
 
335
 
      <varlistentry>
336
 
        <term><option>--help-file-selection</option></term>
337
 
        <listitem>
338
 
          <para>Näyttää ohjetekstin tiedoston valintaikkunan valitsimista.</para>
339
 
        </listitem>
340
 
      </varlistentry>
341
 
 
342
 
      <varlistentry>
343
 
        <term><option>--help-list</option></term>
344
 
        <listitem>
345
 
          <para>Näyttää ohjetekstin luetteloikkunan valitsimista.</para>
346
 
        </listitem>
347
 
      </varlistentry>
348
 
 
349
 
      <varlistentry>
350
 
        <term><option>--help-notification</option></term>
351
 
        <listitem>
352
 
          <para>Näyttää ohjetekstin ilmoituskuvakkeiden valitsimista.</para>
353
 
        </listitem>
354
 
      </varlistentry>
355
 
 
356
 
      <varlistentry>
357
 
        <term><option>--help-progress</option></term>
358
 
        <listitem>
359
 
          <para>Näyttää ohjetekstin edistymisikkunan valitsimista.</para>
360
 
        </listitem>
361
 
      </varlistentry>
362
 
 
363
 
      <varlistentry>
364
 
        <term><option>--help-question</option></term>
365
 
        <listitem>
366
 
          <para>Näyttää ohjetekstin kysymysikkunan valitsimista.</para>
367
 
        </listitem>
368
 
      </varlistentry>
369
 
 
370
 
      <varlistentry>
371
 
        <term><option>--help-warning</option></term>
372
 
        <listitem>
373
 
          <para>Näyttää ohjetekstin varoitusikkunan valitsimista.</para>
374
 
        </listitem>
375
 
      </varlistentry>
376
 
 
377
 
      <varlistentry>
378
 
        <term><option>--help-text-info</option></term>
379
 
        <listitem>
380
 
          <para>Näyttää ohjeen tietoikkunan valitsimista.</para>
381
 
        </listitem>
382
 
      </varlistentry>
383
 
 
384
 
      <varlistentry>
385
 
        <term><option>--help-misc</option></term>
386
 
        <listitem>
387
 
          <para>Näyttää ohjeen sekalaisista valitsimista.</para>
388
 
        </listitem>
389
 
      </varlistentry>
390
 
 
391
 
      <varlistentry>
392
 
        <term><option>--help-gtk</option></term>
393
 
        <listitem>
394
 
          <para>Näyttää ohjeen GTK+-valitsimista.</para>
395
 
        </listitem>
396
 
      </varlistentry>
397
 
 
398
 
    </variablelist>
399
 
 
400
 
  </sect2>
401
 
 
402
 
<!-- ==== Miscellaneous Options ====== -->
403
 
 
404
 
  <sect2 id="zenity-miscellaneous-options">
405
 
    <title>Sekalaisia valitsimia</title>
406
 
 
407
 
    <para><application>Zenity</application>llä on myös seuraavat sekalaiset valitsimet:</para>
408
 
 
409
 
    <variablelist>
410
 
 
411
 
      <varlistentry>
412
 
        <term><option>--about</option></term>
413
 
        <listitem>
414
 
          <para>Näyttää <guilabel>Tietoja Zenitystä</guilabel> -ikkunan, joka sisältää tiedot <application>Zenity</application>n versiosta, tekijänoikeuksista ja kehittäjistä.</para>
415
 
        </listitem>
416
 
      </varlistentry>
417
 
 
418
 
      <varlistentry>
419
 
        <term><option>--version</option></term>
420
 
        <listitem>
421
 
          <para>Näyttää <application>Zenityn</application> versionumeron.</para>
422
 
        </listitem>
423
 
      </varlistentry>
424
 
 
425
 
    </variablelist>
426
 
 
427
 
  </sect2>
428
 
 
429
 
<!-- ==== GTK+ Options ====== -->
430
 
 
431
 
  <sect2 id="zenity-gtk-options">
432
 
    <title>GTK+-valitsimet</title>
433
 
 
434
 
    <para><application>Zenity</application> tarjoaa tavanomaiset GTK+-valitsimet. Lisätietoa GTK+-valitsimista saa komennolla <command>zenity -?</command>.</para>
435
 
 
436
 
  </sect2>
437
 
 
438
 
<!-- ==== Environment variables ==== -->
439
 
 
440
 
  <sect2 id="zenity-environment-variables">
441
 
    <title>Ympäristömuuttujat</title>
442
 
 
443
 
    <para>Normaalisti <application>Zenity</application> tunnistaa pääteikkunan, josta se on käynnistetty ja pitää itsensä tämän ikkunan päällä. Tämä käytös voidaan estää poistamalla <envar>WINDOWID</envar>-ympäristömuuttuja.</para>
444
 
 
445
 
  </sect2>
446
 
 
447
 
  </sect1>
448
 
<!-- ==== Calendar Options ====== -->
449
 
 
450
 
  <sect1 id="zenity-calendar-options">
451
 
    <title>Kalenteri-ikkuna</title>
452
 
 
453
 
    <para>Käytä valitsinta <option>--calendar</option> luomaan kalenteri-ikkuna. <application>Zenity</application> palauttaa valitun päivämäärään vakiotulosteeseen. Mikäli päivämäärää ei määritetty komentorivillä, ikkuna avataan sen hetkisen päivän kohdalta.</para>
454
 
    <para>Kalenteri-ikkuna tarjoaa seuraavat valitsimet:</para>
455
 
 
456
 
    <variablelist>
457
 
 
458
 
      <varlistentry>
459
 
        <term><option>--text</option>=<replaceable>teksti</replaceable></term>
460
 
        <listitem>
461
 
          <para>Määrittää tekstin, joka näkyy kalenteri-ikkunassa.</para>
462
 
        </listitem>
463
 
      </varlistentry>
464
 
        
465
 
      <varlistentry>
466
 
        <term><option>--day</option>=<replaceable>päivä</replaceable></term>
467
 
        <listitem>
468
 
          <para>Määrittää päivän, joka on aluksi valittuna kalenteri-ikkunassa. <replaceable>päivä</replaceable> tulee korvata numerolla 1—31.</para>
469
 
        </listitem>
470
 
      </varlistentry>
471
 
 
472
 
      <varlistentry>
473
 
        <term><option>--month</option>=<replaceable>kuukausi</replaceable></term>
474
 
        <listitem>
475
 
          <para>Määrittää kuukauden, joka on aluksi valittuna kalenteri-ikkunassa. <replaceable>kuukausi</replaceable> tulee korvata numerolla 1—12.</para>
476
 
        </listitem>
477
 
      </varlistentry>
478
 
 
479
 
      <varlistentry>
480
 
        <term><option>--year</option>=<replaceable>vuosi</replaceable></term>
481
 
        <listitem>
482
 
          <para>Määrittää vuoden, joka on aluksi valittuna kalenteri-ikkunassa.</para>
483
 
        </listitem>
484
 
      </varlistentry>
485
 
 
486
 
      <varlistentry>
487
 
        <term><option>--date-format</option>=<replaceable>muoto</replaceable></term>
488
 
        <listitem>
489
 
          <para>Määrittää muotoilun, jossa kalenteri-ikkuna palauttaa päivämäärän valinnan jälkeen. Oletusmuotoilu riippuu maa-asetuksista. <replaceable>muoto</replaceable> täytyy koostua muotoilukoodeista, joita <command>strftime</command>-funktio hyväksyy, kuten <literal>%A %Y-%m-%d</literal>.</para>
490
 
        </listitem>
491
 
      </varlistentry>
492
 
 
493
 
    </variablelist>
494
 
 
495
 
    <para>Seuraava esimerkkiskripti näyttää kuinka luodaan kalenteri-ikkuna: <programlisting>
496
 
        #!/bin/sh
497
 
 
498
 
 
499
 
        if zenity --calendar \
500
 
        --title="Valitse päivä" \
501
 
        --text="Napsauta päivämäärää valitsemaan päivä." \
502
 
        --day=10 --month=8 --year=2004
503
 
          then echo $?
504
 
          else echo "Päivää ei valittu"
505
 
        fi
506
 
      </programlisting></para>
507
 
 
508
 
    <figure id="zenity-calendar-screenshot">
509
 
      <title>Esimerkki kalenteri-ikkunasta</title>
510
 
      <screenshot>
511
 
        <mediaobject>
512
 
          <imageobject>
513
 
              <imagedata fileref="figures/zenity-calendar-screenshot.png" format="PNG"/>
514
 
          </imageobject>
515
 
          <textobject>
516
 
              <phrase>Esimerkki <application>Zenity</application>-kalenteri-ikkunasta</phrase>
517
 
          </textobject>
518
 
        </mediaobject>
519
 
      </screenshot>
520
 
   </figure>
521
 
                                                                                                          
522
 
  </sect1>
523
 
 
524
 
 
525
 
<!-- ==== File Selection Options ====== -->
526
 
 
527
 
  <sect1 id="zenity-file-selection-options">
528
 
    <title>Tiedoston valintaikkuna</title>
529
 
 
530
 
    <para>Käytä valitsinta <option>--file-selection</option> luomaan tiedoston valintaikkuna. <application>Zenity</application> palauttaa valitut tiedostot tai hakemistot vakiotulosteeseen. Oletusmoodi tiedoston valintaikkunalle on avaus.</para>
531
 
    <para>Tiedoston valintaikkuna tarjoaa seuraavat valitsimet:</para>
532
 
 
533
 
    <variablelist>
534
 
 
535
 
      <varlistentry>
536
 
        <term><option>--filename</option>=<replaceable>tiedostonimi</replaceable></term>
537
 
        <listitem>
538
 
          <para>Määrittää tiedoston tai hakemiston, joka on aluksi ikkunan tullessa näkyviin valittuna tiedoston valintaikkunassa.</para>
539
 
        </listitem>
540
 
      </varlistentry>
541
 
 
542
 
      <varlistentry>
543
 
        <term><option>--multiple</option></term>
544
 
        <listitem>
545
 
          <para>Sallii valita kerralla useamman tiedoston tiedoston valintaikkunassa.</para>
546
 
        </listitem>
547
 
      </varlistentry>
548
 
 
549
 
      <varlistentry>
550
 
        <term><option>--directory</option></term>
551
 
        <listitem>
552
 
          <para>Sallii vain hakemistojen valitsemisen tiedoston valintaikkunassa.</para>
553
 
        </listitem>
554
 
      </varlistentry>
555
 
 
556
 
      <varlistentry>
557
 
        <term><option>--save</option></term>
558
 
        <listitem>
559
 
          <para>Asettaa tiedoston valintaikkunan tallennustilaan.</para>
560
 
        </listitem>
561
 
      </varlistentry>
562
 
 
563
 
      <varlistentry>
564
 
        <term><option>--separator</option>=<replaceable>erotin</replaceable></term>
565
 
        <listitem>
566
 
          <para>Määrittää merkkijonon, jota käytetään erottamaan tiedostot palautettavassa tiedostonimien luettelossa.</para>
567
 
        </listitem>
568
 
      </varlistentry>
569
 
 
570
 
    </variablelist>
571
 
 
572
 
    <para>Seuraava esimerkkiskripti näyttää kuinka luodaan tiedoston valintaikkuna: <programlisting>
573
 
        #!/bin/sh
574
 
 
575
 
        FILE=`zenity --file-selection --title="Valitse tiedosto"`
576
 
 
577
 
        case $? in
578
 
                 0)
579
 
                        echo "\"$FILE\" valittu.";;
580
 
                 1)
581
 
                        echo "Tiedostoa ei valittu.";;
582
 
                -1)
583
 
                        echo "Tiedostoa ei valittu.";;
584
 
        esac
585
 
      </programlisting></para>
586
 
 
587
 
    <figure id="zenity-fileselection-screenshot">
588
 
      <title>Esimerkki tiedoston valintaikkunasta</title>
589
 
      <screenshot>
590
 
        <mediaobject>
591
 
          <imageobject>
592
 
            <imagedata fileref="figures/zenity-fileselection-screenshot.png" format="PNG"/>
593
 
          </imageobject>
594
 
          <textobject>
595
 
            <phrase>Esimerkki <application>Zenity</application>n tiedoston valintaikkunasta</phrase>
596
 
          </textobject>
597
 
        </mediaobject>
598
 
      </screenshot>
599
 
    </figure>
600
 
 
601
 
  </sect1>
602
 
 
603
 
<!-- ==== Notification Options ====== -->
604
 
  <sect1 id="zenity-notification-options">
605
 
    <title>Ilmoituskuvake</title>
606
 
 
607
 
    <para>
608
 
    </para>
609
 
 
610
 
    <variablelist>
611
 
 
612
 
      <varlistentry>
613
 
        <term><option>--text</option>=<replaceable>teksti</replaceable></term>
614
 
        <listitem>
615
 
          <para>Määrittää tekstin, joka näkyy ilmoitusalueella.</para>
616
 
        </listitem>
617
 
      </varlistentry>
618
 
 
619
 
    </variablelist>
620
 
 
621
 
    <para>Seuraava esimerkkiskripti näyttää kuinka luodaan ilmoituskuvake: <programlisting>
622
 
        #!/bin/sh
623
 
 
624
 
        zenity --notification\
625
 
          --window-icon="info" \
626
 
          --text="Järjestelmän päivitys on välttämätön!"
627
 
      </programlisting></para>
628
 
 
629
 
    <figure id="zenity-notification-screenshot">
630
 
      <title>Esimerkki ilmoituskuvakkeesta</title>
631
 
      <screenshot>
632
 
        <mediaobject>
633
 
          <imageobject>
634
 
              <imagedata fileref="figures/zenity-notification-screenshot.png" format="PNG"/>
635
 
          </imageobject>
636
 
          <textobject>
637
 
              <phrase>Esimerkki <application>Zenity</application>-ilmoituskuvakkeesta</phrase>
638
 
          </textobject>
639
 
        </mediaobject>
640
 
      </screenshot>
641
 
   </figure>
642
 
                                                                                                          
643
 
  </sect1>
644
 
 
645
 
<!-- ==== List Options ====== -->
646
 
 
647
 
  <sect1 id="zenity-list-options">
648
 
    <title>Luetteloikkuna</title>
649
 
 
650
 
    <para>Käytä valitsinta <option>--list</option> luomaan luetteloikkuna. <application>Zenity</application> palauttaa valittujen rivien ensimmäisten sarakkeiden tiedot vakiotulosteeseen.</para>
651
 
 
652
 
    <para>Ikkunan sisältö tulee määrittää sarake sarakkeelta ja rivi riviltä. Tiedot voidaan syöttää ikkunaan vakiosyötteen kautta. Jokainen tietue pitää erottaa rivinvaihtomerkillä. </para>
653
 
 
654
 
    <para>Mikäli käytössä on valitsin <option>--checklist</option> tai <option>--radiolist</option>, jokaisen rivin tulee alkaa joko 'TRUE' (tosi) tai 'FALSE' (epätosi).</para>
655
 
 
656
 
    <para>Luetteloikkuna tarjoaa seuraavat valitsimet:</para>
657
 
 
658
 
    <variablelist>
659
 
 
660
 
      <varlistentry>
661
 
        <term><option>--column</option>=<replaceable>sarake</replaceable></term>
662
 
        <listitem>
663
 
          <para>Määrittää luetteloikkunassa näkyvien sarakkeiden otsakkeet. Määritä valitsin <option>--column</option> jokaiselle sarakkeelle, jonka haluat näkyvän ikkunassa.</para>
664
 
        </listitem>
665
 
      </varlistentry>
666
 
 
667
 
      <varlistentry>
668
 
        <term><option>--checklist</option></term>
669
 
        <listitem>
670
 
          <para>Määrittää, että ensimmäinen sarake luetteloikkunassa sisältää valintaruutuja.</para>
671
 
        </listitem>
672
 
      </varlistentry>
673
 
 
674
 
      <varlistentry>
675
 
        <term><option>--radiolist</option></term>
676
 
        <listitem>
677
 
          <para>Määrittää, että ensimmäinen sarake luetteloikkunassa sisältää radiovalitsimia.</para>
678
 
        </listitem>
679
 
      </varlistentry>
680
 
 
681
 
      <varlistentry>
682
 
        <term><option>--editable</option></term>
683
 
        <listitem>
684
 
          <para>Sallii näytettävien tietuiden muokaamisen.</para>
685
 
        </listitem>
686
 
      </varlistentry>
687
 
 
688
 
      <varlistentry>
689
 
        <term><option>--separator</option>=<replaceable>erotin</replaceable></term>
690
 
        <listitem>
691
 
          <para>Määrittää mitä merkkijonoa käytetään kun luetteloikkuna palauttaa valitut tietueet.</para>
692
 
        </listitem>
693
 
      </varlistentry>
694
 
 
695
 
      <varlistentry>
696
 
        <term><option>--print-column</option>=<replaceable>sarake</replaceable></term>
697
 
        <listitem>
698
 
          <para>Määrittää mitkä sarakkeet tulostetaan valinnan jälkeen. Oletussarake on "1". "ALL" (kaikki) tarkoittaa, että kaikki luettelon sarakkeet tulostetaan.</para>
699
 
        </listitem>
700
 
      </varlistentry>
701
 
 
702
 
    </variablelist>
703
 
 
704
 
    <para>Seuraava esimerkkiskripti näyttää kuinka luodaan luetteloikkuna: <programlisting>
705
 
        #!/bin/sh
706
 
 
707
 
        zenity --list \
708
 
          --title="Valitse viat joita haluat katsoa" \
709
 
          --column="Vikanumero" --column="Vakavuus" --column="Kuvaus" \
710
 
            992383 normaali "GtkTreeView kaatuu monivalinnoissa" \
711
 
            293823 korkea "GNOME-sanakirja ei osaa käyttää välipalvelinta" \
712
 
            393823 kriittinen "Valikkojen muokaus ei toimi GNOME 2.0:ssa"
713
 
      </programlisting></para>
714
 
 
715
 
    <figure id="zenity-list-screenshot">
716
 
      <title>Esimerkki luetteloikkunasta</title>
717
 
      <screenshot>
718
 
        <mediaobject>
719
 
          <imageobject>
720
 
            <imagedata fileref="figures/zenity-list-screenshot.png" format="PNG"/>
721
 
          </imageobject>
722
 
          <textobject>
723
 
            <phrase>Esimerkki <application>Zenity</application>-luetteloikkunasta</phrase>
724
 
          </textobject>
725
 
        </mediaobject>
726
 
      </screenshot>
727
 
    </figure>
728
 
 
729
 
  </sect1>
730
 
 
731
 
<!-- ==== Message Options ====== -->
732
 
 
733
 
  <sect1 id="zenity-message-options">
734
 
    <title>Viesti-ikkunat</title>
735
 
 
736
 
    <para><application>Zenity</application> voi luoda neljän tyyppisia viesti-ikkunoita:</para>
737
 
    <itemizedlist>
738
 
      <listitem>
739
 
        <para>Virhe</para>
740
 
      </listitem>
741
 
      <listitem>
742
 
        <para>Tiedoksi</para>
743
 
      </listitem>
744
 
      <listitem>
745
 
        <para>Kysymys</para>
746
 
      </listitem>
747
 
      <listitem>
748
 
        <para>Varoitus</para>
749
 
      </listitem>
750
 
    </itemizedlist>
751
 
 
752
 
    <para>Kaikille ikkunatyypeille valitsin <option>--text</option> määrittää ikkunassa näytettävän tekstin.</para>
753
 
 
754
 
    <sect2 id="zenity-error-dialog">
755
 
      <title>Virheikkuna</title>
756
 
 
757
 
      <para>Käytä valitsinta <option>--error</option> luomaan virheikkuna.</para>
758
 
 
759
 
      <para>Seuraava esimerkkiskripti näyttää kuinka luodaan virheikkuna: <programlisting>
760
 
          #!/bin/bash
761
 
 
762
 
          zenity --error \
763
 
          --text="Tiedostoa /var/log/syslog ei löytynyt."
764
 
        </programlisting></para>
765
 
 
766
 
      <figure id="zenity-error-screenshot">
767
 
        <title>Esimerkki virheikkunasta</title>
768
 
        <screenshot>
769
 
          <mediaobject>
770
 
            <imageobject>
771
 
              <imagedata fileref="figures/zenity-error-screenshot.png" format="PNG"/>
772
 
            </imageobject>
773
 
            <textobject>
774
 
              <phrase>Esimerkki <application>Zenity</application>-virheikkuna</phrase>
775
 
            </textobject>
776
 
          </mediaobject>
777
 
        </screenshot>
778
 
      </figure>
779
 
    </sect2>
780
 
 
781
 
    <sect2 id="zenity-info-dialog">
782
 
      <title>Tietoikkuna</title>
783
 
 
784
 
      <para>Käytä valitsinta <option>--info</option> luomaan tietoikkuna.</para>
785
 
 
786
 
      <para>Seuraava esimerkkiskripti näyttää kuinka luodaan tietoikkuna: <programlisting>
787
 
          #!/bin/bash
788
 
 
789
 
          zenity --info \
790
 
          --text="Yhdistäminen valmis. Päivitetty 3/10 tiedostoa."
791
 
        </programlisting></para>
792
 
 
793
 
      <figure id="zenity-information-screenshot">
794
 
        <title>Esimerkki tietoikkunasta</title>
795
 
        <screenshot>
796
 
          <mediaobject>
797
 
            <imageobject>
798
 
              <imagedata fileref="figures/zenity-information-screenshot.png" format="PNG"/>
799
 
            </imageobject>
800
 
            <textobject>
801
 
              <phrase>Esimerkki <application>Zenity</application>-tietoikkunasta</phrase>
802
 
            </textobject>
803
 
          </mediaobject>
804
 
        </screenshot>
805
 
      </figure>
806
 
    </sect2>
807
 
 
808
 
    <sect2 id="zenity-question-dialog">
809
 
      <title>Kysymysikkuna</title>
810
 
 
811
 
      <para>Käytä valitsinta <option>--question</option> luomaan kysymysikkuna.</para>
812
 
 
813
 
      <para>Seuraava esimerkki näyttää kuinka luodaan kysymysikkuna: <programlisting>
814
 
          #!/bin/bash
815
 
 
816
 
          zenity --question \
817
 
          --text="Haluatko varmasti jatkaa?"
818
 
        </programlisting></para>
819
 
 
820
 
      <figure id="zenity-question-screenshot">
821
 
        <title>Esimerkki kysymysikkunasta</title>
822
 
        <screenshot>
823
 
          <mediaobject>
824
 
            <imageobject>
825
 
              <imagedata fileref="figures/zenity-question-screenshot.png" format="PNG"/>
826
 
            </imageobject>
827
 
            <textobject>
828
 
              <phrase>Esimerkki <application>Zenity</application>-kysymysikkunasta</phrase>
829
 
            </textobject>
830
 
          </mediaobject>
831
 
        </screenshot>
832
 
      </figure>
833
 
    </sect2>
834
 
 
835
 
    <sect2 id="zenity-warning-dialog">
836
 
      <title>Varoitusikkuna</title>
837
 
 
838
 
      <para>Käytä valitsinta <option>--warning</option> luomaan varoitusikkuna.</para>
839
 
 
840
 
      <para>Seuraava esimerkki näyttää kuinka luodaan varoitusikkuna: <programlisting>
841
 
          #!/bin/bash
842
 
        
843
 
          zenity --warning \
844
 
          --text="Irrota virtajohto sähköiskujen välttämiseksi."
845
 
        </programlisting></para>
846
 
 
847
 
      <figure id="zenity-warning-screenshot">
848
 
        <title>Esimerkki varoitusikkunasta</title>
849
 
        <screenshot>
850
 
          <mediaobject>
851
 
            <imageobject>
852
 
              <imagedata fileref="figures/zenity-warning-screenshot.png" format="PNG"/>
853
 
            </imageobject>
854
 
            <textobject>
855
 
              <phrase>Esimerkki <application>Zenity</application>-varoitusikkunasta</phrase>
856
 
            </textobject>
857
 
          </mediaobject>
858
 
        </screenshot>
859
 
      </figure>
860
 
    </sect2>
861
 
 
862
 
  </sect1>
863
 
 
864
 
<!-- ==== Progress Options ====== -->
865
 
 
866
 
  <sect1 id="zenity-progress-options">
867
 
    <title>Edistymisikkuna</title>
868
 
 
869
 
    <para>Käytä valitsinta <option>--progress</option> luomaan edistymisikkuna.</para>
870
 
 
871
 
    <para><application>Zenity</application> lukee datan vakiosyötteestä rivi kerrallaan. Mikäli rivi alkaa #-merkillä, teksti päivitetään rivin tekstillä. Mikäli rivi sisältää vain numeron, edistymisprosentiksi päivitetään annettu numero.</para>
872
 
        
873
 
    <para>Edistymisikkuna tarjoaa seuraavat valitsimet:</para>
874
 
 
875
 
    <variablelist>
876
 
 
877
 
      <varlistentry>
878
 
        <term><option>--text</option>=<replaceable>teksti</replaceable></term>
879
 
        <listitem>
880
 
          <para>Määrittää tekstin, joka näytetään edistymisikkunassa.</para>
881
 
        </listitem>
882
 
      </varlistentry>
883
 
 
884
 
      <varlistentry>
885
 
        <term><option>--percentage</option>=<replaceable>prosentit</replaceable></term>
886
 
        <listitem>
887
 
          <para>Määrittää prosentuaalisen osuuden alussa, joka asetetaan edistymisikkunaan.</para>
888
 
        </listitem>
889
 
      </varlistentry>
890
 
 
891
 
      <varlistentry>
892
 
        <term><option>--auto-close</option></term>
893
 
        <listitem>
894
 
          <para>Edistymisikkuna suljetaan automaattisesti kun 100 % saavutetaan.</para>
895
 
        </listitem>
896
 
      </varlistentry>
897
 
 
898
 
      <varlistentry>
899
 
        <term><option>--pulsate</option></term>
900
 
        <listitem>
901
 
          <para>Määrittää, että edistymisikkuna sykkii kunnes EOF-merkki (tiedoston loppumerkki) luetaan vakiosyötteestä.</para>
902
 
        </listitem>
903
 
      </varlistentry>
904
 
 
905
 
    </variablelist>
906
 
 
907
 
    <para>Seuraava esimerkkiskripti näyttää kuinka luodaan edistymisikkuna: <programlisting>
908
 
        #!/bin/sh
909
 
        (
910
 
        echo "10" ; sleep 1
911
 
        echo "# Päivitetään postilokeja" ; sleep 1
912
 
        echo "20" ; sleep 1
913
 
        echo "# Nollataan cron-töitä" ; sleep 1
914
 
        echo "50" ; sleep 1
915
 
        echo "Tämä rivi vain ohitetaan" ; sleep 1
916
 
        echo "75" ; sleep 1
917
 
        echo "# Uudelleenkäynnistetään järjestelmä" ; sleep 1
918
 
        echo "100" ; sleep 1
919
 
        ) |
920
 
        zenity --progress \
921
 
          --title="Päivitetään järjestelmälokeja" \
922
 
          --text="Tutkitaan postilokeja..." \
923
 
          --percentage=0
924
 
 
925
 
        if [ "$?" = -1 ] ; then
926
 
                zenity --error \
927
 
                  --text="Päivitys keskeytetty."
928
 
        fi
929
 
 
930
 
      </programlisting></para>
931
 
 
932
 
    <figure id="zenity-progress-screenshot">
933
 
      <title>Esimerkki edistymisikkunasta</title>
934
 
      <screenshot>
935
 
        <mediaobject>
936
 
          <imageobject>
937
 
            <imagedata fileref="figures/zenity-progress-screenshot.png" format="PNG"/>
938
 
          </imageobject>
939
 
          <textobject>
940
 
            <phrase>Esimerkki <application>Zenity</application>-edistymisikkunasta</phrase>
941
 
          </textobject>
942
 
        </mediaobject>
943
 
      </screenshot>
944
 
    </figure>
945
 
 
946
 
  </sect1>
947
 
 
948
 
<!-- ==== Text Entry Options ====== -->
949
 
 
950
 
  <sect1 id="zenity-text-entry-options">
951
 
    <title>Tekstinsyöttöikkuna</title>
952
 
 
953
 
    <para>
954
 
        Use the <option>--entry</option> option to create a text entry dialog. <application>Zenity</application> returns the contents of the text entry to standard output. 
955
 
    </para>     
956
 
    <para>Tekstinsyöttöikkuna tarjoaa seuraavat valitsimet:</para>
957
 
 
958
 
    <variablelist>
959
 
 
960
 
      <varlistentry>
961
 
        <term><option>--text</option>=<replaceable>teksti</replaceable></term>
962
 
        <listitem>
963
 
          <para>Määrittää tekstin, joka näkyy tekstinsyöttöikkunassa.</para>
964
 
        </listitem>
965
 
      </varlistentry>
966
 
 
967
 
      <varlistentry>
968
 
        <term><option>--entry-text</option>=<replaceable>teksti</replaceable></term>
969
 
        <listitem>
970
 
          <para>Määrittää tekstin, joka näytetään syöttökentässä teksinsyöttöikkunassa.</para>
971
 
        </listitem>
972
 
      </varlistentry>
973
 
 
974
 
      <varlistentry>
975
 
        <term><option>--hide-text</option></term>
976
 
        <listitem>
977
 
          <para>Piilottaa tekstin syöttökentässä tekstinsyöttöikkunassa.</para>
978
 
        </listitem>
979
 
      </varlistentry>
980
 
 
981
 
    </variablelist>
982
 
 
983
 
    <para>Seuraava esimerkkiskripti näyttää kuinka luodaan tekstinsyöttöikkuna: <programlisting>
984
 
        #!/bin/sh
985
 
 
986
 
        if zenity --entry \
987
 
        --title="Lisää syöte" \
988
 
        --text="Syötä _salasanasi:" \
989
 
        --entry-text "salasana" \
990
 
        --hide-text
991
 
          then echo $?
992
 
          else echo "Salasanaa ei syötetty"
993
 
        fi
994
 
      </programlisting></para>
995
 
 
996
 
    <figure id="zenity-entry-screenshot">
997
 
      <title>Esimerkki tekstinsyöttöikkunasta</title>
998
 
      <screenshot>
999
 
        <mediaobject>
1000
 
          <imageobject>
1001
 
            <imagedata fileref="figures/zenity-entry-screenshot.png" format="PNG"/>
1002
 
          </imageobject>
1003
 
          <textobject>
1004
 
            <phrase>Esimerkki <application>Zenity</application>-tekstinsyöttöikkunasta</phrase>
1005
 
          </textobject>
1006
 
        </mediaobject>
1007
 
      </screenshot>
1008
 
    </figure>
1009
 
  </sect1>
1010
 
 
1011
 
<!-- ==== Text Information Options ====== -->
1012
 
 
1013
 
  <sect1 id="zenity-text-options">
1014
 
    <title>Tekstitietoikkuna</title>
1015
 
 
1016
 
    <para>Käytä valitsinta <option>--text-info</option> luomaan tekstitietoikkuna.</para>
1017
 
        
1018
 
    <para>Tekstitietoikkuna tarjoaa seuraavat valitsimet:</para>
1019
 
 
1020
 
    <variablelist>
1021
 
 
1022
 
      <varlistentry>
1023
 
        <term><option>--filename</option>=<replaceable>tiedostonimi</replaceable></term>
1024
 
        <listitem>
1025
 
          <para>Määrittää tiedoston, joka ladataan tekstitietoikkunaan.</para>
1026
 
        </listitem>
1027
 
      </varlistentry>
1028
 
 
1029
 
      <varlistentry>
1030
 
        <term><option>--editable</option></term>
1031
 
        <listitem>
1032
 
          <para>Sallii näytettävän tekstin muokkaamisen. Muokattu teksti palautetaan vakiotulosteeseen kun ikkuna suljetaan.</para>
1033
 
        </listitem>
1034
 
      </varlistentry>
1035
 
 
1036
 
    </variablelist>
1037
 
 
1038
 
    <para>Seuraava esimerkkiskripti näyttää kuinka luodaan tekstitietoikkuna: <programlisting>
1039
 
        #!/bin/sh
1040
 
 
1041
 
        FILE=`zenity --file-selection \
1042
 
          --title="Valitse tiedosto"`
1043
 
 
1044
 
        case $? in
1045
 
                 0)
1046
 
                        zenity --text-info \
1047
 
                          --title=$FILE \
1048
 
                          --filename=$FILE \
1049
 
                          --editable 2&gt;/tmp/tmp.txt;;
1050
 
                 1)
1051
 
                        echo "Tiedostoa ei valittu.";;
1052
 
                -1)
1053
 
                        echo "Tiedostoa ei valittu.";;
1054
 
        esac
1055
 
      </programlisting></para>
1056
 
 
1057
 
    <figure id="zenity-text-screenshot">
1058
 
      <title>Esimerkki tekstilaatikkoikkunasta</title>
1059
 
      <screenshot>
1060
 
        <mediaobject>
1061
 
          <imageobject>
1062
 
            <imagedata fileref="figures/zenity-text-screenshot.png" format="PNG"/>
1063
 
          </imageobject>
1064
 
          <textobject>
1065
 
            <phrase>Esimerkki <application>Zenity</application>-tekstilaatikkoikkunasta</phrase>
1066
 
          </textobject>
1067
 
        </mediaobject>
1068
 
      </screenshot>
1069
 
    </figure>
1070
 
 
1071
 
  </sect1>
1072
 
 
1073
 
</article>