Du kan bruge Zenity til at oprette simple dialoger, der interagerer grafisk med brugeren. Brug

Når du skriver et script, kan du bruge Zenity til at oprette simple dialoger, der interagerer grafisk med brugeren på følgende vis:

Du kan oprette en dialog for at indhente information fra brugeren. For eksempel kan du bede brugeren om at vælge en dato fra en kalenderdialog, eller om at vælge en fil fra en filvælger.

Du kan oprette en dialog for at vise information til brugeren. For eksempel kan du bruge en statusbjælke til at angive status for en handling, eller vise en advarsel til brugeren.

Når brugeren lukker dialogen, vil Zenity udskrive teksten, der blev produceret af dialogen, til standardoutput.

Når du skriver Zenity-kommandoer, så sikr dig, at du skriver anførselstegn omkring hvert argument.

Brug for eksempel:

zenity --calendar --title="Plan for ferie"

Brug ikke:

zenity --calendar --title=Plan for ferie

Hvis du ikke bruger anførselstegn, kan du få uventede resultater.
Genvejstaster

En genvejstast er en tast, der lader dig foretage en handling ved hjælp af tastaturet, frem for at bruge musen til at vælge en kommando fra en menu eller en dialog. Hver genvejstast markeres ved et understreget tegn i en menu eller ved et dialogvalgmulighed.

Visse Zenity-dialoger understøtter genvejstaster. Genvejstaster angives ved at placere en bundstreg umiddelbart før det tegn, der svarer til genvejstasten, i dialogteksten. Følgende eksempel viser hvordan man angiver bogstavet “V” som genvejstast:

"_Vælg et navn".
Afslutningskoder

Zenity returnerer følgende afslutningskoder:

Afslutningskode

Beskrivelse

0

Brugeren har trykket enten OK eller Luk.

1

Brugeren har trykket enten Annullér eller brugt vinduesfunktionerne til at lukke dialogen.

-1

Der opstod en uventet fejl.

5

Dialogen er blevet lukket, fordi tiden er løbet ud.
Generelle tilvalg

Alle Zenity-dialoger understøtter følgende generelle tilvalg:

<cmd>--title</cmd>=<var>titel</var>

Angiver titlen på en dialog.

 <cmd>--window-icon</cmd>=<var>ikonsti</var>

Angiver det ikon, der skal vises i dialogens ramme. Der er fire standardikoner, der kan bruges ved at angive følgende nøgleord: "info", "warning", "question" eller "error".

 <cmd>--width</cmd>=<var>bredde</var>

Angiver dialogens bredde.

 <cmd>--height</cmd>=<var>højde</var>

Angiver dialogens højde.

 <cmd>--timeout</cmd>=<var>ventetid</var>

Angiver ventetiden i sekunder, hvorefter dialogen lukkes.
Hjælpetilvalg

Zenity stiller følgende hjælpetilvalg til rådighed:

<cmd>--help</cmd>

Viser en kort hjælpetekst.

 <cmd>--help-all</cmd>

Viser den fulde hjælpetekst for alle dialoger.

 <cmd>--help-general</cmd>

Viser hjælpetekst for generelle tilvalg til dialoger.

 <cmd>--help-calendar</cmd>

Viser hjælpetekst for tilvalg til kalenderdialog.

 <cmd>--help-entry</cmd>

Viser hjælpetekst for tilvalg til tekstfeltdialog.

 <cmd>--help-error</cmd>

Viser hjælpetekst for tilvalg til dialoger med fejlmeddelelser.

 <cmd>--help-info</cmd>

Viser hjælpetekst for tilvalg til informationsdialog.

 <cmd>--help-file-selection</cmd>

Viser hjælpetekst for tilvalg til filvælgerdialog.

 <cmd>--help-list</cmd>

Viser hjælpetekst for tilvalg til listedialog.

 <cmd>--help-notification</cmd>

Viser hjælpetekst for tilvalg til påmindelsesikon.

 <cmd>--help-progress</cmd>

Viser hjælpetekst for tilvalg til statusbjælkedialog.

 <cmd>--help-question</cmd>

Viser hjælpetekst for tilvalg til spørgsmålsdialog.

 <cmd>--help-warning</cmd>

Viser hjælpetekst for tilvalg til advarselsdialog.

 <cmd>--help-text-info</cmd>

Viser hjælpetekst for tilvalg til tekstinformationsdialog.

 <cmd>--help-misc</cmd>

Viser hjælpetekst for diverse tilvalg.

 <cmd>--help-gtk</cmd>

Viser hjælp til GTK+-tilvalg.
Diverse tilvalg

Zenity stiller yderligere følgende "diverse" tilvalg til rådighed:

<cmd>--about</cmd>

Viser dialogen Om Zenity, som indeholder versionsinformation, ophavsretsinformation samt udviklerinformation om Zenity.

 <cmd>--version</cmd>

Viser versionsnummeret for Zenity.
GTK+-tilvalg

Zenity understøtter standard-GTK+-tilvalgene. Kør kommandoen zenity --help-gtk for at få yderligere information om GTK+-tilvalg.

Miljøvariable

Normalt vil Zenity detektere terminalvinduet, hvorfra det er blevet kørt, og holde sit eget vindue over dette vindue. Denne opførsel kan slås fra ved at nulstille miljøvariablen WINDOWID.