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 i stä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:

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

# 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 aviseringsikonflaggor.

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

# Diverse flaggor

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

## --about

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

## --version

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.