Aplikaci Zenity můžete využít k vytváření jednoduchých dialogových oken pro komunikaci s uživatelem v grafickém prostředí.

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.

Tato příručka je součástí sbírky příruček GNOME šířených za podmínek licence GNU FDL. Pokud chcete tento dokument šířit odděleně od sbírky, musíte přiložit kopii licence dle popisu v oddílu 6 dané licence.

Mnoho názvů použitých firmami k zviditelnění produktů nebo služeb jsou ochranné známky. Na místech, kde jsou tyto názvy v dokumentaci použity a členové Dokumentačního projektu GNOME jsou si vědomi skutečnosti, že se jedná o ochrannou známku, je takovýto název psán velkými písmeny celý nebo s velkým písmenem na začátku.

DOKUMENT A JEHO UPRAVENÉ VERZE JSOU ŠÍŘENY V SOULADU SE ZNĚNÍM LICENCE GNU FREE DOCUMENTATION LICENSE S NÁSLEDUJÍCÍM USTANOVENÍM:

DOKUMENT JE POSKYTOVÁN V PODOBĚ „JAK JE“, BEZ ZÁRUKY JAKÉHOKOLIV DRUHU, NEPOSKYTUJÍ SE ANI ODVOZENÉ ZÁRUKY, ZÁRUKY, ŽE DOKUMENT, NEBO JEHO UPRAVENÁ VERZE, JE BEZCHYBNÝ, NEBO ZÁRUKY PRODEJNOSTI, VHODNOSTI PRO URČITÝ ÚČEL, NEBO NEPORUŠENOSTI. RIZIKO NEKVALITY, NEPŘESNOSTI A ŠPATNÉHO PROVEDENÍ DOKUMENTU, NEBO JEHO UPRAVENÉ VERZE, NESETE VY. POKUD JE TENTO DOKUMENT NEBO JEHO UPRAVENÁ VERZE VADNÁ V JAKÉMKOLIV SMYSLU, VY (NIKOLIV PŮVODCE, AUTOR NEBO JAKÝKOLIV PŘISPĚVATEL) PŘEBÍRÁTE ODPOVĚDNOST ZA JAKÉKOLIV NÁKLADY NA NUTNÉ ÚPRAVY, OPRAVY ČI SLUŽBY. TOTO PROHLÁŠENÍ O ZÁRUCE PŘEDSTAVUJE ZÁKLADNÍ SOUČÁST TÉTO LICENCE. BEZ TOHOTO PROHLÁŠENÍ NENÍ PODLE TÉTO DOHODY POVOLENO UŽÍVÁNÍ ANI ÚPRAVY TOHOTO DOKUMENTU; DÁLE

ZA ŽÁDNÝCH OKOLNOSTÍ A ŽÁDNÝCH PRÁVNÍCH PŘEDPOKLADŮ, AŤ SE JEDNÁ O PŘEČIN (VČETNĚ NEDBALOSTNÍCH), SMLOUVU NEBO JINÉ, NENÍ AUTOR, PŮVODNÍ PISATEL, KTERÝKOLIV PŘISPĚVATEL NEBO KTERÝKOLIV DISTRIBUTOR TOHOTO DOKUMENTU NEBO UPRAVENÉ VERZE DOKUMENTU NEBO KTERÝKOLIV DODAVATEL NĚKTERÉ Z TĚCHTO STRAN ODPOVĚDNÝ NĚJAKÉ OSOBĚ ZA PŘÍMÉ, NEPŘÍMÉ, SPECIÁLNÍ, NAHODILÉ NEBO NÁSLEDNÉ ŠKODY JAKÉHOKOLIV CHARAKTERU, VČETNĚ, ALE NEJEN, ZA POŠKOZENÍ ZE ZTRÁTY DOBRÉHO JMÉNA, PŘERUŠENÍ PRÁCE, PORUCHY NEBO NESPRÁVNÉ FUNKCE POČÍTAČE NEBO JINÉHO A VŠECH DALŠÍCH ŠKOD NEBO ZTRÁT VYVSTÁVAJÍCÍCH Z NEBO VZTAHUJÍCÍCH SE K POUŽÍVÁNÍ TOHOTO DOKUMENTU NEBO UPRAVENÝCH VERZÍ DOKUMENTU, I KDYŽ BY TAKOVÁTO STRANA BYLA INFORMOVANÁ O MOŽNOSTI TAKOVÉHOTO POŠKOZENÍ.

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.

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