Användning

När du skriver skript kan du använda Zenity för att skapa enkla dialogrutor som interagerar grafiskt med användaren. Här är några exempel:

  • Du kan skapa en dialogruta för att hämta in information från användaren. Till exempel kan du fråga användaren om att välja ett datum från en kalenderdialog, eller att välja en fil från en filväljardialog.
  • Du kan skapa en dialogruta för att tillhandahålla information till användaren. Till exempel kan du använda en förloppsdialog för att indikera aktuell status för en åtgärd, eller använda en varningsdialog för att larma användaren.

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

Var noga med att skriva citationstecken runt varje argument när du skriver Zenity-kommandon.

Till exempel, använd:

zenity --calendar --title="Semesterplanerare"
Använd inte:
zenity --calendar --title=Semesterplanerare

Om du inte använder citationstecken kan du få oväntade resultat.

2.1. Snabbtangenter

En snabbtangent är en tangent som låter dig genomföra en åtgärd från tangentbordet istället för att använda musen för att välja ett kommando från en meny eller dialog. Varje snabbtangent identifieras av en understruken bokstav i en meny eller dialogflagga.

Vissa dialoger i Zenity har stöd för användningen av snabbtangenter. För att specificera tecknet som ska användas som snabbtangenten, placera ett understreck före den bokstaven i dialogens text. Följande exempel visar hur man specificerar bokstaven "V" som en snabbtangent:

"_Välj ett namn".

2.2. Avslutningskoder

Zenity returnerar följande avslutningskoder:

Avslutningskod Beskrivning
0 Användaren har antingen tryckt på OK eller Stäng.
1 Användaren har antingen tryckt på Avbryt, eller använt fönsterfunktioner för att stänga dialogrutan.
-1 Ett oväntat fel har inträffat.
5 Dialogrutan har stängts därför att tidsgränsen har nåtts.

2.3. Allmänna alternativ

Alla dialoger i Zenity har stöd för följande allmänna flaggor:

--title=titel

Anger titeln på en dialogruta.

--window-icon=ikonsökväg

Anger ikonen som visas i fönsterramen för dialogen. Det finns 4 standardikoner som finns tillgängliga genom att ange något av följande nyckelord - "info", "warning", "question" och "error".

--width=bredd

Anger bredden på dialogrutan.

--height=höjd

Anger höjden på dialogrutan.

--timeout=tidsgräns

Anger tidsgränsen i sekunder efter vilken dialogrutan stängs.

2.4. Hjälpflaggor

Zenity tillhandahåller följande hjälpflaggor:

--help

Visar förkortad hjälptext.

--help-all

Visar fullständig hjälptext för alla dialoger.

--help-general

Visar hjälptext för allmänna dialogflaggor.

--help-calendar

Visar hjälptext för kalenderdialogflaggor.

--help-entry

Visar hjälptext för textinmatningsdialogflaggor.

--help-error

Visar hjälptext för feldialogflaggor.

--help-info

Visar hjälptext för informationsdialogflaggor.

--help-file-selection

Visar hjälptext för filväljardialogflaggor.

--help-list

Visar hjälptext för listdialogflaggor.

--help-notification

Visar hjälptext för notifieringsikonflaggor.

--help-progress

Visar hjälptext för förloppsdialogflaggor.

--help-question

Visar hjälptext för frågedialogflaggor.

--help-warning

Visar hjälptext för varningsdialogflaggor.

--help-text-info

Visar hjälp för textinformationsdialogflaggor.

--help-misc

Visar hjälp för diverse flaggor.

--help-gtk

Visar hjälp för GTK+-flaggor.

2.5. Diverse flaggor

Zenity tillhandahåller även följande diverse flaggor:

--about

Visar dialogrutan Om Zenity, vilken innehåller versionsinformation, copyrightinformation, och utvecklarinformation om Zenity.

--version

Visar versionsnumret för Zenity.

2.6. GTK+-flaggor

Zenity har stöd för standard-GTK+-flaggor. För mer information om GTK+-flaggorna, kör kommandot zenity -?.

2.7. Environment Variables

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.