Brug

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

  • Du kan oprette et dialogvindue for at indhente information fra brugeren. For eksempel kan du bede brugeren om at vælge en dato fra et kalendervindue, eller om at vælge en fil fra en filvælger.
  • Du kan oprette et dialogvindue for at vise information til brugeren. For eksempel kan du bruge en statusbjælke til at angive status for en operation, eller vise en advarsel til brugeren.

Når brugeren lukker dialogvinduet, vil Zenity udskrive teksten, der blev produceret af vinduet, til standard output.

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

Brug for eksempel:

zenity --calendar --title="Planer for ferie"
Brug ikke:
zenity --calendar --title=Planer for ferie

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

2.1. 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 et dialogvindue. Hver genvejstast markeres ved et understreget tegn i en menu eller ved et dialogvalgmulighed.

Visse Zenity-dialogvinduer 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 "C" som genvejstast:

"_Vælg et navn".

2.2. Afslutningskoder

Zenity returnerer følgende afslutningskoder:

Afslutningskode Beskrivelse
0 Brugeren har trykket enten O.k. eller Luk.
1 Brugeren har trykket enten Annullér eller brugt vinduesfunktionerne til at lukke dialogvinduet.
-1 Der opstod en uventet fejl.
5 Dialogvinduet er blevet lukket, fordi tiden er løbet ud.

2.3. Generelle tilvalg

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

--title=titel

Angiver titel på et dialogvindue.

--window-icon=ikonsti

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

--width=bredde

Angiver dialogvinduets bredde.

--height=højde

Angiver dialogvinduets højde.

--timeout=tidsudløb

Angiver tidsudløbet i sekunder, hvorefter dialogvinduet lukkes.

2.4. Hjælpetilvalg

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

--help

Viser en kort hjælpetekst.

--help-all

Viser den fulde hjælpetekst for alle dialogvinduer.

--help-general

Viser hjælpetekst til de generelle dialogtilvalg.

--help-calendar

Viser hjælpetekst for kalenderdialogvinduets tilvalg.

--help-entry

Viser hjælpetekst for tilvalg til tekstindtastningsfelter.

--help-error

Viser hjælpetekst for tilvalg til dialogvinduer med fejlmeddelelser.

--help-info

Viser hjælpetekst for tilvalg til dialogvinduer med informationsmeddelelser.

--help-file-selection

Viser hjælpetekst til filvælgerdialogvinduer.

--help-list

Viser hjælpetekst til listedialogvinduer.

--help-notification

Viser hjælpetekst til påmindelsesikoner.

--help-progress

Viser hjælpetekst til statusbjælkedialogvinduer.

--help-question

Viser hjælpetekst til spørgsmålsdialogvinduer.

--help-warning

Viser hjælpetekst til advarselsdialogvinduer.

--help-text-info

Viser hjælpetekst til informationsdialogvinduer.

--help-misc

Viser hjælpetekst til diverse tilvalg.

--help-gtk

Viser hjælp til GTK+-tilvalg.

2.5. Diverse tilvalg

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

--about

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

--version

Viser versionsnummeret for denne udgave af Zenity.

2.6. GTK+-tilvalg

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

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