You can use Zenity to create simple dialogs that interact graphically with the user.

# Käyttö

When you write scripts, you can use Zenity to create simple dialogs that interact graphically with the user, as follows:

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ää.

When the user closes the dialog, Zenity prints the text produced by the dialog to standard output.

When you write Zenity commands, ensure that you place quotation marks around each argument.

For example, use:

    zenity --calendar --title="Holiday Planner"

Do not use:

    zenity --calendar --title=Holiday Planner

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

# 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.

Some Zenity dialogs support the use of access keys. To specify the character to use as the access key, place an underscore before that character in the text of the dialog. The following example shows how to specify the letter 'C' as the access key:

    "_Choose a name".

# Päättymiskoodit

Zenity returns the following exit codes:

Päättymiskoodi | Kuvaus
--- | ---
0 | The user has pressed either OK or Close.
1 | The user has either pressed Cancel, or used the window functions to close the dialog.
-1 | Tapahtui odottamaton virhe.
5 | Ikkuna suljettiin aikarajan päätyttyä.

# Yleiset valitsimet

All Zenity dialogs support the following general options:

## --title=title

Määrittää ikkunan otsikon.

## --window-icon=icon_path

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=width

Määrittää ikkunan leveyden.

## --height=height

Määrittää ikkunan korkeuden.

## --timeout=timeout

Määrittää aikarajan sekunteina, jonka jälkeen ikkuna suljetaan.

# Ohjevalitsimet

Zenity provides the following help options:

## --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.

# Sekalaisia valitsimia

Zenity also provides the following miscellaneous options:

## --about

Displays the About Zenity dialog, which contains Zenity version information, copyright information, and developer information.

## --version

Displays the version number of Zenity.

# GTK+-valitsimet

Zenity supports the standard GTK+ options. For more information about the GTK+ options, execute the zenity --help-gtk command.

# Ympäristömuuttujat

Normally, Zenity detects the terminal window from which it was launched and keeps itself above that window. This behavior can be disabled by unsetting the WINDOWID environment variable.