Användning

Du kan använda Zenity för att skapa enkla dialogrutor som interagerar grafiskt med användaren. Daniel Nylander po@danielnylander.se 2006, 2009 Sebastian Rasmussen sebras@gmail.com 2016 Användning

När du skriver skript kan du använda Zenity för att skapa enkla dialogrutor som interagerar grafiskt med användaren enligt följande:

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.

När användaren stänger dialogrutan, skriver Zenity ut texten som producerats av dialogrutan till standard ut.

När du skriver Zenity-kommandon, säkerställ att du placerar citationstecken runt varje argument.

Använd till exempel:

zenity --calendar --title="Min helgplanerare"

Använd inte:

zenity --calendar --title=Min helgplanerare

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

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 Zenity-dialoger har stöd för användningen av snabbtangenter. För att ange 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".

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.

Allmänna alternativ

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

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

Anger titeln på en dialogruta.

<cmd>--window-icon</cmd>=<var>ikonsökväg</var>

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

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

Anger bredden på dialogrutan.

<cmd>--height</cmd>=<var>höjd</var>

Anger höjden på dialogrutan.

<cmd>--timeout</cmd>=<var>tidsgräns</var>

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

Hjälpflaggor

Zenity tillhandahåller följande hjälpflaggor:

Visar förkortad hjälptext.

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

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

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

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

Visar hjälptext för kalenderdialogflaggor.

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

Visar hjälptext för textinmatningsdialogflaggor.

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

Visar hjälptext för feldialogflaggor.

Visar hjälptext för informationsdialogflaggor.

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

Visar hjälptext för filväljardialogflaggor.

Visar hjälptext för listdialogflaggor.

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

Visar hjälptext för aviseringsikonflaggor.

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

Visar hjälptext för förloppsdialogflaggor.

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

Visar hjälptext för frågedialogflaggor.

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

Visar hjälptext för varningsdialogflaggor.

Visar hjälp för textinformationsdialogflaggor.

Visar hjälp för diverse flaggor.

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

Diverse flaggor

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

<cmd>--about</cmd>

Visar dialogrutan Om Zenity, vilken innehåller versionsinformation för Zenity, upphovsrättsinformation, och utvecklarinformation.

<cmd>--version</cmd>

Visar versionsnumret för Zenity.

GTK+-flaggor

Zenity har stöd för standardflaggorna för GTK+. För mer information om GTK+-flaggorna, kör kommandot zenity --help-gtk.

Miljövariabler

Normalt kommer Zenity att identifiera terminalfönstret från vilket det startades och håller sig själv ovanför det fönstret. Detta beteende kan inaktiveras genom att tömma ur miljövariabeln WINDOWID.