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"
Älä sen sijaan käytä:
zenity --calendar --title=Loman suunnittelu

Mikäli et käytä lainausmerkkejä, saatat saada odottamattomia tuloksia.

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 OK tai Sulje.
1 Käyttäjä painoi Peru 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.

2.6. GTK+-valitsimet

Zenity tarjoaa tavanomaiset GTK+-valitsimet. Lisätietoa GTK+-valitsimista saa komennolla zenity -?.

2.7. Ympäristömuuttujat

Normaalisti Zenity 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 WINDOWID-ympäristömuuttuja.