Du kan använda Zenity för att skapa enkla dialogrutor som interagerar grafiskt med användaren.

This work is licensed under a GNU Free Documentation License Version 1.1 or any later version.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link.

Denna handbok utgör en av flera GNOME-handböcker som distribueras under villkoren i GFDL. Om du vill distribuera denna handbok separat från övriga handböcker kan du göra detta genom att lägga till en kopia av licensavtalet i handboken enligt instruktionerna i avsnitt 6 i licensavtalet.

Flera namn på produkter och tjänster är registrerade varumärken. I de fall dessa namn förekommer i GNOME-dokumentation - och medlemmarna i GNOME-dokumentationsprojektet är medvetna om dessa varumärken - är de skrivna med versaler eller med inledande versal.

DOKUMENTET OCH MODIFIERADE VERSIONER AV DOKUMENTET TILLHANDAHÅLLS UNDER VILLKOREN I GNU FREE DOCUMENTATION LICENSE ENDAST UNDER FÖLJANDE FÖRUTSÄTTNINGAR:

DOKUMENTET TILLHANDAHÅLLS I "BEFINTLIGT SKICK" UTAN NÅGRA SOM HELST GARANTIER, VARE SIG UTTRYCKLIGA ELLER UNDERFÖRSTÅDDA, INKLUSIVE, MEN INTE BEGRÄNSAT TILL, GARANTIER ATT DOKUMENTET ELLER EN MODIFIERAD VERSION AV DOKUMENTET INTE INNEHÅLLER NÅGRA FELAKTIGHETER, ÄR LÄMPLIGT FÖR ETT VISST ÄNDAMÅL ELLER INTE STRIDER MOT LAG. HELA RISKEN VAD GÄLLER KVALITET, EXAKTHET OCH UTFÖRANDE AV DOKUMENTET OCH MODIFIERADE VERSIONER AV DOKUMENTET LIGGER HELT OCH HÅLLET PÅ ANVÄNDAREN. OM ETT DOKUMENT ELLER EN MODIFIERAD VERSION AV ETT DOKUMENT SKULLE VISA SIG INNEHÅLLA FELAKTIGHETER I NÅGOT HÄNSEENDE ÄR DET DU (INTE DEN URSPRUNGLIGA SKRIBENTEN, FÖRFATTAREN ELLER NÅGON ANNAN MEDARBETARE) SOM FÅR STÅ FÖR ALLA EVENTUELLA KOSTNADER FÖR SERVICE, REPARATIONER ELLER KORRIGERINGAR. DENNA GARANTIFRISKRIVNING UTGÖR EN VÄSENTLIG DEL AV DETTA LICENSAVTAL. DETTA INNEBÄR ATT ALL ANVÄNDNING AV ETT DOKUMENT ELLER EN MODIFIERAD VERSION AV ETT DOKUMENT BEVILJAS ENDAST UNDER DENNA ANSVARSFRISKRIVNING;

UNDER INGA OMSTÄNDIGHETER ELLER INOM RAMEN FÖR NÅGON LAGSTIFTNING, OAVSETT OM DET GÄLLER KRÄNKNING (INKLUSIVE VÅRDSLÖSHET), KONTRAKT ELLER DYLIKT, SKA FÖRFATTAREN, DEN URSPRUNGLIGA SKRIBENTEN ELLER ANNAN MEDARBETARE ELLER ÅTERFÖRSÄLJARE AV DOKUMENTET ELLER AV EN MODIFIERAD VERSION AV DOKUMENTET ELLER NÅGON LEVERANTÖR TILL NÅGON AV NÄMNDA PARTER STÄLLAS ANSVARIG GENTEMOT NÅGON FÖR NÅGRA DIREKTA, INDIREKTA, SÄRSKILDA ELLER OFÖRUTSEDDA SKADOR ELLER FÖLJDSKADOR AV NÅGOT SLAG, INKLUSIVE, MEN INTE BEGRÄNSAT TILL, SKADOR BETRÄFFANDE FÖRLORAD GOODWILL, HINDER I ARBETET, DATORHAVERI ELLER NÅGRA ANDRA TÄNKBARA SKADOR ELLER FÖRLUSTER SOM KAN UPPKOMMA PÅ GRUND AV ELLER RELATERAT TILL ANVÄNDNINGEN AV DOKUMENTET ELLER MODIFIERADE VERSIONER AV DOKUMENTET, ÄVEN OM PART SKA HA BLIVIT INFORMERAD OM MÖJLIGHETEN TILL SÅDANA SKADOR.

Daniel Nylander
po@danielnylander.se 2006, 2009
Sebastian Rasmussen
sebras@gmail.com 2016
Anders Jonsson
anders.jonsson@norsjovallen.se 2023

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

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