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"
zenity --calendar --title=Planer for ferie
Hvis du ikke bruger anførselstegn, kan du få uventede resultater.
- 2.1. Genvejstaster
- 2.2. Afslutningskoder
- 2.3. Generelle tilvalg
- 2.4. Hjælpetilvalg
- 2.5. Diverse tilvalg
- 2.6. GTK+-tilvalg
- 2.7. Miljøvariable
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 eller . |
1 | Brugeren har trykket enten 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.