Käyttö
Skriptejä kirjoitettaessa voi Zenityä käyttää yksinkertaisten valintaikkunoiden luomiseen, jotka pyytävät käyttäjältä syötettä graafisesti, kuten seuraavissa tapauksissa:
- 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.
- 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ää.
Kun käyttäjä sulkee ikkunan, Zenity tulostaa ikkunaan syötetyn tekstin vakiotulosteeseen.
Kun kirjoitat Zenity-komentoja, ole tarkkana lainausmerkkien sijoittelussa jokaisen argumentin ympärillä.
Käytä esimerkiksi:
zenity --calendar --title="Loman suunnittelu"
zenity --calendar --title=Loman suunnittelu
Mikäli et käytä lainausmerkkejä, saatat saada odottamattomia tuloksia.
- 2.1. Valintanäppäimet
- 2.2. Päättymiskoodit
- 2.3. Yleiset valitsimet
- 2.4. Ohjevalitsimet
- 2.5. Sekalaisia valitsimia
- 2.6. GTK+-valitsimet
- 2.7. Ympäristömuuttujat
2.1. Valintanäppäimet
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.
Jotkut Zenity-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:
"_Valitse nimi".
2.2. Päättymiskoodit
Zenity palauttaa seuraavia päättymiskoodeja:
Päättymiskoodi | Kuvaus |
---|---|
0 | Käyttäjä painoi joko tai . |
1 | Käyttäjä painoi tai käytti ikkunapainikkeita sulkemaan valintaikkunan. |
-1 | Tapahtui odottamaton virhe. |
5 | Ikkuna suljettiin aikarajan päätyttyä. |
2.3. Yleiset valitsimet
Kaikki Zenity-ikkunat tukevat seuraavia yleisiä valitsimia:
- --title=otsikko
-
Määrittää ikkunan otsikon.
- --window-icon=kuvakepolku
-
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).
- --width=leveys
-
Määrittää ikkunan leveyden.
- --height=korkeus
-
Määrittää ikkunan korkeuden.
- --timeout=aikaraja
-
Määrittää aikarajan sekunteina, jonka jälkeen ikkuna suljetaan.
2.4. Ohjevalitsimet
Zenity tarjoaa seuraavat ohjevalitsimet:
- --help
-
Näyttää lyhennetyn ohjetekstin.
- --help-all
-
Näyttää täyden ohjetekstin kaikista ikkunatyypeistä.
- --help-general
-
Näyttää ohjetekstin yleisistä ikkunavalitsimista.
- --help-calendar
-
Näyttää ohjetekstin kalenteri-ikkunan valitsimista.
- --help-entry
-
Näyttää ohjetekstin tekstisyöttöikkunan valitsimista.
- --help-error
-
Näyttää ohjetekstin virheikkunan valitsimista.
- --help-info
-
Näyttää ohjetekstin tietoikkunan valitsimista.
- --help-file-selection
-
Näyttää ohjetekstin tiedoston valintaikkunan valitsimista.
- --help-list
-
Näyttää ohjetekstin luetteloikkunan valitsimista.
- --help-notification
-
Näyttää ohjetekstin ilmoituskuvakkeiden valitsimista.
- --help-progress
-
Näyttää ohjetekstin edistymisikkunan valitsimista.
- --help-question
-
Näyttää ohjetekstin kysymysikkunan valitsimista.
- --help-warning
-
Näyttää ohjetekstin varoitusikkunan valitsimista.
- --help-text-info
-
Näyttää ohjeen tietoikkunan valitsimista.
- --help-misc
-
Näyttää ohjeen sekalaisista valitsimista.
- --help-gtk
-
Näyttää ohjeen GTK+-valitsimista.
2.5. Sekalaisia valitsimia
Zenityllä on myös seuraavat sekalaiset valitsimet:
- --about
-
Näyttää Tietoja Zenitystä -ikkunan, joka sisältää tiedot Zenityn versiosta, tekijänoikeuksista ja kehittäjistä.
- --version
-
Näyttää Zenityn versionumeron.