<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="usage" lang="cs">
<info>
  <link type="guide" xref="index"/>
  <desc>Aplikaci <app>Zenity</app> můžete využít k vytváření jednoduchých dialogových oken pro komunikaci s uživatelem v grafickém prostředí.</desc>
  <license xmlns="http://projectmallard.org/1.0/" href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">

  <p>This work is licensed under a
  <link href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">GNU Free
  Documentation License Version 1.1</link> or any later version.</p>

	<p>
	  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 href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">link</link>.
         </p>
         <p>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.</p>

	<p>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.</p>

	<p>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:</p>
	<list>
		<item>
		  <p>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</p>
		</item>
		<item>
		  <p>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Í.</p>
		</item>
	  </list>
</license>
<credit type="translator copyright"><name>Marek Černocký</name><email>marek@manet.cz</email><years>2009, 2010, 2013</years></credit></info>
<title>Použití</title>
    <p>Pokud píšete skripty, můžete využít aplikaci <app>Zenity</app> 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:</p>
    <list>
      <item>
        <p>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.</p>
      </item>
      <item>
        <p>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.</p>
      </item>
    </list>
    <p>Po té, co uživatel zavře dialogové okno, vypíše aplikace <app>Zenity</app> získaný text na standardní výstup.</p>

    <note>
      <p>Při zapisování příkazů <app>Zenity</app> se ujistěte, že máte všechny argumenty uzavřené do uvozovek.</p>
      <p>Například použijte:</p>
      <screen>zenity --calendar --title="Plán oslav"</screen>
      <p>Nepoužívejte:</p>
      <screen>zenity --calendar --title=Plán oslav</screen>
      <p>Pokud uvozovky nepoužijete, můžete získat nepředvídatelné výsledky.</p>
    </note>

    <section id="zenity-usage-mnemonics">
      <title>Horké klávesy</title>
	<p>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.</p>
	<p>Některá dialogová okna <app>Zenity</app> 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“</p>
	<screen><input>"_Změnit název".</input></screen>
    </section>

    <section id="zenity-usage-exitcodes">
      <title>Návratové kódy</title>
    <p><app>Zenity</app> vrací následující návratové kódy:</p>

    <table frame="all" rules="all">
        <thead>
          <tr>
            <td>
              <p>Návratový kód</p></td>
            <td>
              <p>Popis</p></td>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>
              <p><var>0</var></p>
            </td>
            <td>
              <p>Uživatel zmáčkl <gui style="button">Budiž</gui> nebo <gui style="button">Zavřít</gui>.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>1</var></p>
            </td>
            <td>
              <p>Uživatel buď zmáčkl <gui style="button">Zrušit</gui> nebo použil ovládací prvky okna k jeho zavření.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>-1</var></p>
            </td>
            <td>
              <p>Vyskytla se neznámá chyba.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>5</var></p>
            </td>
            <td>
              <p>Dialogové okno bylo zavřeno, protože vypršel časový limit.</p>
            </td>
          </tr>
        </tbody>
    </table>

    </section>


  <!-- ==== General Options ====== -->

  <section id="zenity-usage-general-options">
    <title>Všeobecné přepínače</title>

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

    <terms>

      <item>
        <title><cmd>--title</cmd>=<var>NÁZEV</var></title>
	<p>Určuje název do záhlaví dialogového okna.</p>
      </item>

      <item>
        <title><cmd>--window-icon</cmd>=<var>CESTA_K_IKONĚ</var></title>
	<p>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).</p>
      </item>

      <item>
        <title><cmd>--width</cmd>=<var>ŠÍŘKA</var></title>
	<p>Určuje šířku dialogového okna.</p>
      </item>

      <item>
        <title><cmd>--height</cmd>=<var>VÝŠKA</var></title>
	<p>Určuje výšku dialogového okna.</p>
      </item>

      <item>
        <title><cmd>--timeout</cmd>=<var>ČASOVÝ_LIMIT</var></title>
	<p>Určuje časový limit v sekundách, po kterém se dialogové okno zavře.</p>
      </item>

    </terms>

  </section>

<!-- ==== Miscellaneous Options ====== -->

  <section id="zenity-help-options">
    <title>Přepínače nápovědy</title>

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

    <terms>

      <item>
        <title><cmd>--help</cmd></title>
	<p>Zobrazí zkrácenou nápovědu.</p>
      </item>

      <item>
        <title><cmd>--help-all</cmd></title>
	<p>Zobrazí celou nápovědu pro všechny typy dialogových oken.</p>
      </item>
 
      <item>
        <title><cmd>--help-general</cmd></title>
	<p>Zobrazí nápovědu pro všeobecné přepínače dialogových oken.</p>
      </item>
 
      <item>
        <title><cmd>--help-calendar</cmd></title>
	<p>Zobrazí nápovědu pro přepínače dialogového okna s kalendářem.</p>
      </item>
 
      <item>
        <title><cmd>--help-entry</cmd></title>
	<p>Zobrazí nápovědu pro přepínače dialogového okna pro vkládání údajů.</p>
      </item>
 
      <item>
        <title><cmd>--help-error</cmd></title>
	<p>Zobrazí nápovědu pro přepínače dialogového okna s chybovým hlášením.</p>
      </item>
 
      <item>
        <title><cmd>--help-info</cmd></title>
	<p>Zobrazí nápovědu pro přepínače dialogového okna s informačním hlášením.</p>
      </item>
 
      <item>
        <title><cmd>--help-file-selection</cmd></title>
	<p>Zobrazí nápovědu pro přepínače dialogového okna pro výběr souboru.</p>
      </item>
 
      <item>
        <title><cmd>--help-list</cmd></title>
	<p>Zobrazí nápovědu pro přepínače dialogového okna se seznamem.</p>
      </item>
 
      <item>
        <title><cmd>--help-notification</cmd></title>
	<p>Zobrazí nápovědu pro přepínače oznamovací ikony.</p>
      </item>
 
      <item>
        <title><cmd>--help-progress</cmd></title>
	<p>Zobrazí nápovědu pro přepínače dialogového okna s ukazatele průběhu.</p>
      </item>
 
      <item>
        <title><cmd>--help-question</cmd></title>
	<p>Zobrazí nápovědu pro přepínače dialogového okna s dotazem.</p>
      </item>
 
      <item>
        <title><cmd>--help-warning</cmd></title>
	<p>Zobrazí nápovědu pro přepínače dialogového okna s varovným hlášením.</p>
      </item>
 
      <item>
	<title><cmd>--help-text-info</cmd></title>
	<p>Zobrazí nápovědu pro přepínače dialogového okna s informačním textem.</p>
      </item>
 
      <item>
        <title><cmd>--help-misc</cmd></title>
	<p>Zobrazí nápovědu pro různé přepínače.</p>
      </item>
 
      <item>
        <title><cmd>--help-gtk</cmd></title>
	<p>Zobrazí nápovědu pro přepínače GTK+.</p>
      </item>
 
    </terms>

  </section>

<!-- ==== Miscellaneous Options ====== -->

  <section id="zenity-miscellaneous-options">
    <title>Různé přepínače</title>

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

    <terms>

      <item>
        <title><cmd>--about</cmd></title>
	<p>Zobrazí dialogové okno <gui>O aplikaci Zenity</gui>, které obsahuje informace o verzi <app>Zenity</app>, informace o autorských právech a informace o vývojářích.</p>
      </item>

      <item>
        <title><cmd>--version</cmd></title>
	<p>Zobrazí číslo verze aplikace <app>Zenity</app>.</p>
      </item>

    </terms>

  </section>

<!-- ==== GTK+ Options ====== -->

  <section id="zenity-gtk-options">
    <title>Přepínače GTK+</title>

    <p>Aplikace <app>Zenity</app> 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 <cmd>zenity --help-gtk</cmd>.</p>

  </section>

<!-- ==== Environment variables ==== -->

  <section id="zenity-environment-variables">
    <title>Proměnné prostředí</title>

    <p>Normálně aplikace <app>Zenity</app> 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í <var>WINDOWID</var>.</p>

  </section>
</page>
