<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY author1 "Sun">
<!ENTITY author2 "Java Desktop System Documentation Team">
<!ENTITY publisher "Sun Microsystems, Inc.">
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appversion "2.6.0">
<!ENTITY app "<application>MateDialog</application>">
<!ENTITY appname "MateDialog">
<!ENTITY date "August 2004">
<!ENTITY manrevision "2.0">
]>
<!-- ================ Document Header ================= -->
<article id="index" lang="cs">

  <articleinfo>
    <title>Příručka k aplikaci MateDialog</title>
    <subtitle>Příručka V2.0 k aplikaci MateDialog</subtitle>
    <copyright lang="en">
	    <year>2003</year>
	    <year>2004</year>
	    <holder>Sun Microsystems, Inc.</holder>
    </copyright>

    <!-- Translators: uncomment this
    <copyright>
	    <year>2004</year>
	    <holder>ME_THE_TRANSLATOR</holder>
    </copyright>
    -->

    <publisher>
	    <publishername>Sun Microsystems, Inc.</publishername>
    </publisher>

      <legalnotice id="legalnotice">
	<para>Je povoleno kopírovat, šířit a/nebo upravovat tento dokument za podmínek GNU Free Documentation License, verze 1.1 nebo jakékoli další verze vydané nadací Free Software Foundation; bez neměnných oddílů, bez textů předních desek a bez textů zadních desek. Kopie této licence je zahrnuta v oddílu jménem <ulink type="help" url="help:fdl">GNU Free Documentation License</ulink> nebo v souboru COPYING-DOCS dodávaném s touto příručkou.</para>
         <para>Tato příručka je součástí kolekce příruček MATE, distribuovaných pod licencí GNU FDL. Pokud chcete tento dokument šířit odděleně od kolekce, musíte přiložit kopii licence dle popisu v sekci 6 dané licence.</para>

	<para>Mnoho užívaných jmen určených k zviditelnění produktů nebo služeb jsou ochranné známky. Na místech, kde jsou tato jména v dokumentaci užita a členové Dokumentačního projektu MATE jsou si vědomi skutečnosti, že se jedná o ochrannou známku, je takové jméno psáno velkými písmeny celé nebo s velkým písmenem na začátku.</para>

	<para lang="en">
	  DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
	  UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
	  WITH THE FURTHER UNDERSTANDING THAT:

	  <orderedlist>
		<listitem>
		  <para lang="en">DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
                    EXCEPT UNDER THIS DISCLAIMER; AND
		  </para>
		</listitem>
		<listitem>
		  <para lang="en">UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
                       THE POSSIBILITY OF SUCH DAMAGES.
		  </para>
		</listitem>
	  </orderedlist>
	</para>
  </legalnotice>



    <authorgroup>
      <author lang="en">
        <firstname>Sun</firstname>
        <surname>Java Desktop System Documentation Team</surname>
        <affiliation><orgname>Sun Microsystems, Inc.</orgname></affiliation>
      </author>
      <author role="maintainer" lang="en">
        <firstname>Glynn</firstname>
        <surname>Foster</surname>
        <affiliation>
          <orgname>MATE Documentation Project</orgname>
        </affiliation>
      </author>
      <editor lang="en">
        <firstname>Nicholas</firstname>
        <surname>Curran</surname>
        <affiliation>
          <orgname>MATE Documentation Project</orgname>
        </affiliation>
      </editor>
    </authorgroup>

    <revhistory>
      <revision lang="en">
        <revnumber>MateDialog Desktop Application Manual V2.0</revnumber>
        <date>August 2004</date>
        <revdescription>
          <para role="author" lang="en">Sun Java Desktop System Documentation Team</para>
          <para role="publisher" lang="en">Sun Microsystems, Inc.</para>
        </revdescription>
      </revision>

      <revision lang="en">
        <revnumber>MateDialog Manual V1.0</revnumber>
        <date>January 2003</date>
        <revdescription>
          <para role="author" lang="en">Glynn Foster</para>
          <para role="publisher" lang="en"> MATE Documentation Project </para>
        </revdescription>
      </revision>
    </revhistory>

    <releaseinfo>Tato příručka popisuje aplikaci MateDialog ve verzi 2.6.0.</releaseinfo>

    <legalnotice>
	    <title>Ohlasy</title>
	    <para>Pokud chcete zaslat náměty a připomínky, použijte následující přímý odkaz na <ulink url="help:mate-feedback" type="help">Stránku s ohlasy</ulink>.</para>
<!-- Translators may also add here feedback address for translations -->

    </legalnotice>
    <abstract role="description">
            <para>MateDialog je přepsaný gdialog, což je port MATE aplikace dialog, která slouží k zobrazování dialogových oken z příkazové řádky a skriptů shellu.</para>
    </abstract>
  </articleinfo>
  
  <indexterm lang="en">
    <primary>matedialog command</primary>
  </indexterm>
  <indexterm lang="en">
    <primary>dialog creator</primary>
  </indexterm>
<!-- ================ Document Body ================= -->

<!-- ==== Introduction ====== -->

  <sect1 id="matedialog-introduction">
    <title>Úvod</title>

    <para>Aplikace <application>MateDialog</application> vám umožňuje vytvářet následující typy jednoduchých dialogových oken:</para>

    <itemizedlist>
        <listitem><para>Kalendář</para></listitem>
	<listitem><para>Výběr souboru</para></listitem>
	<listitem><para>Seznam</para></listitem>
	<listitem><para>Oznamovací ikona</para></listitem>
        <listitem><para>Zpráva</para>
            <itemizedlist>
	        <listitem><para>Chybové hlášení</para></listitem>
		<listitem><para>Informační hlášení</para></listitem>
		<listitem><para>Dotaz</para></listitem>
		<listitem><para>Varovné hlášení</para></listitem>
	    </itemizedlist>
	</listitem>
	<listitem><para>Ukazatel průběhu</para></listitem>
        <listitem><para>Textový vstup</para></listitem>
	<listitem><para>Textová informace</para></listitem>
    </itemizedlist>

  </sect1>

<!-- ==== Usage ====== -->

  <sect1 id="matedialog-usage">
    <title>Použití</title>

    <para>Pokud píšete skripty, můžete využít aplikaci <application>MateDialog</application> 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í dva účely:</para>
    <itemizedlist>
      <listitem>
        <para>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.</para>
      </listitem>
      <listitem>
        <para>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.</para>
      </listitem>
    </itemizedlist>
    <para>Po té, co uživatel zavře dialog, vypíše aplikace <application>MateDialog</application> text vytvořený dialogem na standardní výstup.</para>

    <note>
      <para>Při zapisování příkazů <application>MateDialog</application> se ujistěte, že máte všechny argumenty uzavřené do uvozovek.</para>
      <para lang="en">
        For example, use: <screen lang="en"><userinput><command>matedialog --calendar --title="Holiday Planner"</command></userinput></screen> Do not use: <screen lang="en"><userinput><command>matedialog --calendar --title=Holiday Planner</command></userinput></screen>
      </para>
      <para>Pokud uvozovky nepoužijete, můžete získat nepředvídatelné výsledky.</para>
    </note>

    <sect2 id="matedialog-usage-mnemonics">
      <title>Horké klávesy</title>
	<para>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.</para>
	<para>Některá dialogová okna <application>MateDialog</application> 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“</para>
	<screen lang="en"><userinput>"_Choose a name".</userinput></screen>
    </sect2>

    <sect2 id="matedialog-usage-exitcodes">
      <title>Návratové kódy</title>
    <para><application>MateDialog</application> vrací následující návratové kódy:</para>

    <informaltable frame="all">
      <tgroup cols="2" colsep="1" rowsep="1">
        <colspec colname="COLSPEC0" colwidth="50*"/>
        <colspec colname="COLSPEC1" colwidth="50*"/>
        <thead>
          <row valign="top">
            <entry colname="COLSPEC0">
              <para>Návratový kód</para></entry>
            <entry colname="COLSPEC1">
              <para>Popis</para></entry>
          </row>
        </thead>
        <tbody>
          <row valign="top">
            <entry>
              <para lang="en"><varname>0</varname></para>
            </entry>
            <entry>
              <para>Uživatel zmáčkl buď <guibutton>OK</guibutton> nebo <guibutton>Zavřít</guibutton>.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>1</varname></para>
            </entry>
            <entry>
              <para>Uživatel buď zmáčkl <guibutton>Zrušit</guibutton> nebo použil ovládací prvky okna k zavření dialogu.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>-1</varname></para>
            </entry>
            <entry>
              <para>Vyskytla se neznámá chyba.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>5</varname></para>
            </entry>
            <entry>
              <para>Dialogové okno bylo zavřeno, protože vypršel časový limit.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>

    </sect2>


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

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

    <para>Všechna dialogová okna <application>MateDialog</application> podporují následující všeobecné přepínače:</para>

    <variablelist>

      <varlistentry>
        <term><option>--title</option>=<replaceable>název</replaceable></term>
	<listitem>
	  <para>Určuje název dialogového okna.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--window-icon</option>=<replaceable>cesta_k_ikoně</replaceable></term>
	<listitem>
	  <para>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).</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--width</option>=<replaceable>šířka</replaceable></term>
	<listitem>
	  <para>Určuje šířku dialogového okna.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--height</option>=<replaceable>výška</replaceable></term>
	<listitem>
	  <para>Určuje výšku dialogového okna.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--timeout</option>=<replaceable>časový_limit</replaceable></term>
	<listitem>
	  <para>Určuje časový limit v sekundách, po kterém se dialog zavře.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

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

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

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

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--help</option></term>
	<listitem>
	  <para>Zobrazí zkrácenou nápovědu.</para>
	</listitem>
      </varlistentry>

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

  </sect2>

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

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

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

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--about</option></term>
	<listitem>
	  <para>Zobrazí dialogové okno <guilabel>O aplikaci MateDialog</guilabel>, které obsahuje informace o verzi <application>MateDialog</application>, informace o autorských právech a informace o vývojářích.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--version</option></term>
	<listitem>
	  <para>Zobrazí číslo verze aplikace <application>MateDialog</application>.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

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

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

    <para>Aplikace <application>MateDialog</application> 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 <command>matedialog -?</command>.</para>

  </sect2>

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

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

    <para>Normálně <application>MateDialog</application> 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í <envar>WINDOWID</envar>.</para>

  </sect2>

  </sect1>
<!-- ==== Calendar Options ====== -->

  <sect1 id="matedialog-calendar-options">
    <title>Dialogové okno s kalendářem</title>

    <para>K vytvoření dialogového okna s kalendářem použijte přepínač <option>--calendar</option>. Aplikace <application>MateDialog</application> vrátí vybrané datum na standardní výstup. Pokud neurčíte v příkazovém řádku žádné datum, použije se aktuální.</para>
    <para>Dialogové okno s kalendářem podporuje následující přepínače:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Určuje text, který se v dialogovém okně s kalendářem zobrazí.</para>
	</listitem>
      </varlistentry>
     	
      <varlistentry>
        <term><option>--day</option>=<replaceable>den</replaceable></term>
	<listitem>
	  <para>Určuje den, který bude v kalendáři vybraný. <replaceable>den</replaceable> musí být číslo v rozmezí 1 až 31 včetně.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--month</option>=<replaceable>měsíc</replaceable></term>
	<listitem>
	  <para>Určuje měsíc, který bude v kalendáři vybraný. <replaceable>měsíc</replaceable> musí být číslo v rozmezí 1 až 12 včetně.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--year</option>=<replaceable>rok</replaceable></term>
	<listitem>
	  <para>Určuje rok, který bude v kalendáři vybraný.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--date-format</option>=<replaceable>formát</replaceable></term>
	<listitem>
	  <para>Určuje formát, v jakém má dialogové okno s kalendářem vrátit vybrané datum. Výchozí formát je daný vaším národním prostředím. <replaceable>formát</replaceable> musí být formát, který akceptuje funkce <command>strftime</command>, např. <literal>%A %d/%m/%y</literal>.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a calendar dialog:

      <programlisting lang="en">
        #!/bin/sh


        if matedialog --calendar \
        --title="Select a Date" \
        --text="Click on a date to select that date." \
        --day=10 --month=8 --year=2004
          then echo $?
          else echo "No date selected"
        fi
      </programlisting>

    </para>

    <figure id="matedialog-calendar-screenshot">
      <title>Příklad dialogového okna s kalendářem</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
              <imagedata fileref="figures/matedialog-calendar-screenshot.png" format="PNG"/>
          </imageobject>
          <textobject>
              <phrase><application>MateDialog</application> calendar dialog example</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
   </figure>
													  
  </sect1>


<!-- ==== File Selection Options ====== -->

  <sect1 id="matedialog-file-selection-options">
    <title>Dialogové okno s výběrem souboru</title>

    <para>K vytvoření dialogového okna s výběrem souboru použijte přepínač <option>--file-selection</option>. Aplikace <application>MateDialog</application> vrátí vybrané soubory nebo složky na standardní výstup. Výchozí režim dialogového okna s výběrem souboru je open (otevřít).</para>
    <para>Dialogové okno s výběrem souboru podporuje následující přepínače:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>název_souboru</replaceable></term>
	<listitem>
	  <para>Určuje soubor nebo složku, kteří budou vybraní po prvním spuštění dialogového okna.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--multiple</option></term>
	<listitem>
	  <para>Umožní v dialogovém okně vybrat více souborů naráz.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--directory</option></term>
	<listitem>
	  <para>Umožní v dialogovém okně pouze výběr složek.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--save</option></term>
	<listitem>
	  <para>Přepne dialogové okno s výběrem souboru do režimu save (uložit).</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--separator</option>=<replaceable>oddělovač</replaceable></term>
	<listitem>
	  <para>Určuje řetězec, který se použije k oddělení jednotlivých názvů souborů ve vráceném seznamu.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a file selection dialog:

      <programlisting lang="en">
        #!/bin/sh

        FILE=`matedialog --file-selection --title="Select a File"`

        case $? in
                 0)
                        echo "\"$FILE\" selected.";;
                 1)
                        echo "No file selected.";;
                -1)
                        echo "No file selected.";;
        esac
      </programlisting>
    </para>

    <figure id="matedialog-fileselection-screenshot">
      <title>Příklad dialogového okna na výběr souboru</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-fileselection-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> file selection dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Notification Options ====== -->
  <sect1 id="matedialog-notification-options">
    <title>Oznamovací ikona</title>

    <para>
    </para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Určuje text, který se zobrazí v oznamovací oblasti.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a notification icon:
      <programlisting lang="en">
        #!/bin/sh

        matedialog --notification\
          --window-icon="info" \
          --text="There are system updates necessary!"
      </programlisting>

    </para>

    <figure id="matedialog-notification-screenshot">
      <title>Příklad oznamovací ikony </title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
              <imagedata fileref="figures/matedialog-notification-screenshot.png" format="PNG"/>
          </imageobject>
          <textobject>
              <phrase><application>MateDialog</application> notification icon example</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
   </figure>
													  
  </sect1>

<!-- ==== List Options ====== -->

  <sect1 id="matedialog-list-options">
    <title>Dialogové okno se seznamem</title>

    <para>K vytvoření dialogového okna se seznamem použijte přepínač <option>--list</option>. Aplikace <application>MateDialog</application> vrátí položky z prvního sloupce vybraných řádků na standardní výstup.</para>

    <para>Data pro dialogové okno se musí zadat sloupec po sloupci, řádek po řádku. Data lze dialogovému oknu předat i přes standardní vstup. Každá položka musí být oddělená znakem nového řádku.</para>

    <para>Pokud použijete přepínače <option>--checklist</option> nebo <option>--radiolist</option>, musí každý řádek začínat buď hodnotou „TRUE“ (bude zaškrtnuté) nebo „FALSE“ (nebude zaškrtnuté).</para>

    <para>Dialogové okno se seznamem podporuje následující přepínače:</para>

    <variablelist>

      <varlistentry>
        <term><option>--column</option>=<replaceable>sloupec</replaceable></term>
	<listitem>
	  <para>Určuje záhlaví sloupců zobrazených v seznamu. Přepínač <option>--column</option> musíte zadat opakovaně zvlášť pro každý ze sloupců, které chcete v seznamu zobrazit.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--checklist</option></term>
	<listitem>
	  <para>Určuje, že první sloupec v seznamu bude obsahovat zaškrtávací pole.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--radiolist</option></term>
	<listitem>
	  <para>Určuje, že první sloupec v seznamu bude obsahovat skupinový přepínač.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
	<listitem>
	  <para>Povolit v zobrazených položkách provádění úprav.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--separator</option>=<replaceable>oddělovač</replaceable></term>
	<listitem>
	  <para>Určuje řetězec použitý jako oddělovač vybraných položek seznamu, které dialogové okno vrátí.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--print-column</option>=<replaceable>sloupec</replaceable></term>
	<listitem>
	  <para>Určuje sloupec, který se má z vybraného řádku vracet. Výchozí hodnota je „1“. Pokud chcete vrátit všechny sloupce seznamu, můžete použít hodnotu „ALL“.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a list dialog:
      <programlisting lang="en">
        #!/bin/sh

        matedialog --list \
          --title="Choose the Bugs You Wish to View" \
          --column="Bug Number" --column="Severity" --column="Description" \
            992383 Normal "GtkTreeView crashes on multiple selections" \
            293823 High "MATE Dictionary does not handle proxy" \
            393823 Critical "Menu editing does not work in MATE 2.0"
      </programlisting>

    </para>

    <figure id="matedialog-list-screenshot">
      <title>Příklad dialogového okna se seznamem</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-list-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> list dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Message Options ====== -->

  <sect1 id="matedialog-message-options">
    <title>Dialogové okno s hlášením</title>

    <para>Aplikace <application>MateDialog</application> umí vytvářet čtyři typy dialogových oken s hlášením:</para>
    <itemizedlist>
      <listitem>
        <para>Chybové hlášení</para>
      </listitem>
      <listitem>
        <para>Informační hlášení</para>
      </listitem>
      <listitem>
        <para>Dotaz</para>
      </listitem>
      <listitem>
        <para>Varovné hlášení</para>
      </listitem>
    </itemizedlist>

    <para>U každého z typů použijte přepínač <option>--text</option> k zadání textu, který se má v dialogovém okně zobrazit.</para>

    <sect2 id="matedialog-error-dialog">
      <title>Dialogové okno s chybovým hlášením</title>

      <para>K vytvoření dialogového okna s chybovým hlášením použijte přepínač <option>--error</option>.</para>

      <para lang="en">
        The following example script shows how to create an error dialog:

        <programlisting lang="en">
          #!/bin/bash

          matedialog --error \
          --text="Could not find /var/log/syslog."
        </programlisting>

      </para>

      <figure id="matedialog-error-screenshot">
        <title>Příklad dialogového okna s chybovým hlášením</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-error-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> error dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="matedialog-info-dialog">
      <title>Dialogové okno s informačním hlášením</title>

      <para>K vytvoření dialogového okna s informačním hlášením použijte přepínač <option>--info</option>.</para>

      <para lang="en">
        The following example script shows how to create an information dialog:

        <programlisting lang="en">
          #!/bin/bash

          matedialog --info \
          --text="Merge complete. Updated 3 of 10 files."
        </programlisting>

      </para>

      <figure id="matedialog-information-screenshot">
        <title>Příklad dialogového okna s informačním hlášením</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-information-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> information dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="matedialog-question-dialog">
      <title>Dialogové okno s dotazem</title>

      <para>K vytvoření dialogového okna s dotazem použijte přepínač <option>--question</option>.</para>

      <para lang="en">
        The following example script shows how to create a question dialog:

        <programlisting lang="en">
          #!/bin/bash

          matedialog --question \
          --text="Are you sure you wish to proceed?"
        </programlisting>

      </para>

      <figure id="matedialog-question-screenshot">
        <title>Příklad dialogového okna s dotazem</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-question-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> question dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="matedialog-warning-dialog">
      <title>Dialogové okno s varovným hlášením</title>

      <para>K vytvoření dialogového okna s varovným hlášením použijte přepínač <option>--warning</option>.</para>

      <para lang="en">
        The following example script shows how to create a warning dialog:

        <programlisting lang="en">
          #!/bin/bash
        
          matedialog --warning \
          --text="Disconnect the power cable to avoid electrical shock."
        </programlisting>

      </para>

      <figure id="matedialog-warning-screenshot">
        <title>Příklad dialogového okna s varovným hlášením</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-warning-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> warning dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

  </sect1>

<!-- ==== Progress Options ====== -->

  <sect1 id="matedialog-progress-options">
    <title>Dialogové okno s ukazatelem průběhu</title>

    <para>K vytvoření dialogového okna s ukazatelem průběhu použijte přepínač <option>--progress</option>.</para>

    <para>Aplikace <application>MateDialog</application> čte data ze standardního vstupu řádek po řádku. Když řádek začíná znakem #, provede se aktualizace textu pomocí textu na zbytku tohoto řádku. Když řádek obsahuje pouze číslo, aktualizují se procenta ukazatele.</para>
	
    <para>Dialogové okno s ukazatelem průběhu podporuje následující přepínače:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Určuje text, který se má v dialogovém okně zobrazit.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--percentage</option>=<replaceable>procenta</replaceable></term>
	<listitem>
	  <para>Určuje počáteční stav procent, na které se má ukazatel průběhu nastavit.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--auto-close</option></term>
	<listitem>
	  <para>Zavřít dialogové okno po dosažení 100%.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--pulsate</option></term>
	<listitem>
	  <para>Určuje, že ukazatel průběhu bude pulzovat, dokud se ze standardního vstupu nenačte znak EOF (konce souboru).</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a progress dialog:
      <programlisting lang="en">
        #!/bin/sh
        (
        echo "10" ; sleep 1
        echo "# Updating mail logs" ; sleep 1
        echo "20" ; sleep 1
        echo "# Resetting cron jobs" ; sleep 1
        echo "50" ; sleep 1
        echo "This line will just be ignored" ; sleep 1
        echo "75" ; sleep 1
        echo "# Rebooting system" ; sleep 1
        echo "100" ; sleep 1
        ) |
        matedialog --progress \
          --title="Update System Logs" \
          --text="Scanning mail logs..." \
          --percentage=0

        if [ "$?" = -1 ] ; then
                matedialog --error \
                  --text="Update canceled."
        fi

      </programlisting>

    </para>

    <figure id="matedialog-progress-screenshot">
      <title>Příklad dialogového okna s ukazatelem průběhu</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-progress-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> progress dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Text Entry Options ====== -->

  <sect1 id="matedialog-text-entry-options">
    <title>Dialogové okno s vkládáním údajů</title>

    <para>K vytvoření dialogového okna s textovým vstupem použijte přepínač <option>--entry</option>. Aplikace <application>MateDialog</application> vrátí zadaný text na standardní výstup.</para>	
    <para>Dialogové okno s vkládáním údajů podporuje následující přepínače:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Určuje text, který se má v dialogovém okně zobrazit.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--entry-text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Určujte text, který se má zobrazit ve vstupním poli dialogového okna.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--hide-text</option></term>
	<listitem>
	  <para>Skrýt text ve vstupním poli dialogového okna.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a text entry dialog:

      <programlisting lang="en">
        #!/bin/sh

        if matedialog --entry \
        --title="Add an Entry" \
        --text="Enter your _password:" \
        --entry-text "password" \
        --hide-text
          then echo $?
          else echo "No password entered"
        fi
      </programlisting>

    </para>

    <figure id="matedialog-entry-screenshot">
      <title>Příklad dialogového okna na vkládání údajů</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-entry-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> text entry dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>
  </sect1>

<!-- ==== Text Information Options ====== -->

  <sect1 id="matedialog-text-options">
    <title>Dialogové okno s informačním textem</title>

    <para>K vytvoření dialogového okna s informačním textem použijte přepínač <option>--text-info</option>.</para>
	
    <para>Dialogové okno s informačním textem podporuje následující přepínače:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>název_souboru</replaceable></term>
	<listitem>
	  <para>Určuje soubor, ze kterého se má do dialogového okna načíst text.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
        <listitem>
          <para>Povolit provádění úprav zobrazeného textu. Upravený text bude po zavření dialogového okna vrácen na standardní výstup.</para>
        </listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a text information dialog:
      <programlisting lang="en">
        #!/bin/sh

        FILE=`matedialog --file-selection \
          --title="Select a File"`

        case $? in
                 0)
                        matedialog --text-info \
                          --title=$FILE \
                          --filename=$FILE \
                          --editable 2&gt;/tmp/tmp.txt;;
                 1)
                        echo "No file selected.";;
                -1)
                        echo "No file selected.";;
        esac
      </programlisting>

    </para>

    <figure id="matedialog-text-screenshot">
      <title>Příklad dialogového okna s informačním textem</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-text-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> text information dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

</article>
