Aplikaci Zenity můžete využít k vytváření jednoduchých dialogových oken pro komunikaci s uživatelem v grafickém prostředí.
Marek Černocký
marek@manet.cz 2009, 2010, 2013

# Použití

Pokud píšete skripty, můžete využít aplikaci Zenity k vytváření jednoduchých dialogových oken, díky čemuž můžete graficky komunikovat s uživatelem. Využití je pro následující účely:

Můžete vytvořit dialogové okno k získání informací od uživatele. Například se můžete uživatele dotázat na datum pomocí výběru z dialogového okna s kalendářem nebo na název souboru pomocí dialogového okna pro výběr souboru.

Můžete vytvořit dialogové okno pro sdělení informace uživateli. Například můžete použít dialogové okno s ukazatelem průběhu k informování o stavu operace nebo dialogové okno s varovnou zprávou k upozornění uživatele.

Po té, co uživatel zavře dialogové okno, vypíše aplikace Zenity získaný text na standardní výstup.

Při zapisování příkazů Zenity se ujistěte, že máte všechny argumenty uzavřené do uvozovek.

Například použijte:

    zenity --calendar --title="Plán oslav"

Nepoužívejte:

    zenity --calendar --title=Plán oslav

Pokud uvozovky nepoužijete, můžete získat nepředvídatelné výsledky.

# Horké klávesy

Horké klávesy jsou klávesy, které vám umožňují provádět činnost z klávesnice místo abyste museli použít myš k výběru z nabídky nebo dialogového okna. Každá horká klávesa je symbolizovaná podtržením příslušného písmene v položce nabídky nebo dialogového okna.

Některá dialogová okna Zenity podporují horké klávesy. Pokud chcete určit, že některý znak má fungovat jako horká klávesa, umístěte před něj podtržítko. Následující příklad ukazuje, jak určit jako horkou klávesu znak „Z“

    "_Změnit název".

# Návratové kódy

Zenity vrací následující návratové kódy:

Návratový kód | Popis
--- | ---
0 | Uživatel zmáčkl Budiž nebo Zavřít.
1 | Uživatel buď zmáčkl Zrušit nebo použil ovládací prvky okna k jeho zavření.
-1 | Vyskytla se neznámá chyba.
5 | Dialogové okno bylo zavřeno, protože vypršel časový limit.

# Všeobecné přepínače

Všechna dialogová okna Zenity podporují následující obecné přepínače:

## --title=NÁZEV

Určuje název do záhlaví dialogového okna.

## --window-icon=CESTA_K_IKONĚ

Určuje ikonu, která se zobrazí v záhlaví dialogového okna. K dispozici jsou také 4 předdefinované ikony dostupné pomocí klíčových slov „info“ (informace), „warning“ (varování), „question“ (dotaz) a „error“ (chyba).

## --width=ŠÍŘKA

Určuje šířku dialogového okna.

## --height=VÝŠKA

Určuje výšku dialogového okna.

## --timeout=ČASOVÝ_LIMIT

Určuje časový limit v sekundách, po kterém se dialogové okno zavře.

# Přepínače nápovědy

Zenity poskytuje následující přepínače pro nápovědu:

## --help

Zobrazí zkrácenou nápovědu.

## --help-all

Zobrazí celou nápovědu pro všechny typy dialogových oken.

## --help-general

Zobrazí nápovědu pro všeobecné přepínače dialogových oken.

## --help-calendar

Zobrazí nápovědu pro přepínače dialogového okna s kalendářem.

## --help-entry

Zobrazí nápovědu pro přepínače dialogového okna pro vkládání údajů.

## --help-error

Zobrazí nápovědu pro přepínače dialogového okna s chybovým hlášením.

## --help-info

Zobrazí nápovědu pro přepínače dialogového okna s informačním hlášením.

## --help-file-selection

Zobrazí nápovědu pro přepínače dialogového okna pro výběr souboru.

## --help-list

Zobrazí nápovědu pro přepínače dialogového okna se seznamem.

## --help-notification

Zobrazí nápovědu pro přepínače oznamovací ikony.

## --help-progress

Zobrazí nápovědu pro přepínače dialogového okna s ukazatele průběhu.

## --help-question

Zobrazí nápovědu pro přepínače dialogového okna s dotazem.

## --help-warning

Zobrazí nápovědu pro přepínače dialogového okna s varovným hlášením.

## --help-text-info

Zobrazí nápovědu pro přepínače dialogového okna s informačním textem.

## --help-misc

Zobrazí nápovědu pro různé přepínače.

## --help-gtk

Zobrazí nápovědu pro přepínače GTK+.

# Různé přepínače

Zenity poskytuje také následující různorodé přepínače:

## --about

Zobrazí dialogové okno O aplikaci Zenity, které obsahuje informace o verzi Zenity, informace o autorských právech a informace o vývojářích.

## --version

Zobrazí číslo verze aplikace Zenity.

# Přepínače GTK+

Aplikace Zenity podporuje standardní přepínače GTK+. Více informací o přepínačích GTK+ získáte spuštěním příkazu zenity --help-gtk.

# Proměnné prostředí

Normálně aplikace Zenity detekuje terminálové okno, ze kterého byla spuštěná a drží se nad tímto oknem. Toto chování lze zakázat zrušením nastavení proměnné prostředí WINDOWID.