<?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="fi">

  <articleinfo>
    <title>MateDialogn ohje</title>
    <subtitle>MateDialog-työpöytäsovelluksen ohje v2.0</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>Tätä asiakirjaa saa kopioida, jakaa edelleen ja/tai muokata Free Software Foundationin julkaiseman GNU Free Documentation Licensen (GFDL) version 1.1 tai valinnaisesti myöhemmän version mukaisesti, ilman vaatimuksia muuttamattomista osioista ja etu- tai takakansiteksteistä. Kopion GFDL:stä voi nähdä napsauttamalla <ulink type="help" url="help:fdl">tätä linkkiä</ulink>, tai lukemalla ohjeen mukana toimitetun COPYING-DOCS-nimisen tiedoston.</para>
         <para>Tämä käyttöohje on osa Maten käyttöohjekokoelmaa, jota levitetään GFDL-lisenssin alaisena. Jos haluat levittää tätä käyttöohjetta erillään kokoelmasta, voit tehdä sen liittämällä lisenssin kopion ohjeen mukaan, kuten lisenssin luku 6 sanelee.</para>

	<para>Monet nimistä, joita yhtiöt käyttävät tuotteistansa ja palveluistansa, ovat tuotemerkkejä. Maten dokumentointiprojektissa nämä nimet pyritään kirjoittamaan suuraakkosin tai isolla alkukirjaimella, sikäli kun projektin jäsenet tietävät kyseisistä tuotemerkeistä.</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>Tämä ohjekirja kuvaa MateDialogn versiota 2.6.0.</releaseinfo>

    <legalnotice>
	    <title>Palaute</title>
	    <para>Palautetta voi lähettää seuraamalla ohjeita <ulink url="help:mate-feedback" type="help">palautesivulla</ulink>.</para>
<!-- Translators may also add here feedback address for translations -->

    </legalnotice>
    <abstract role="description">
            <para>MateDialog on uudelleenkirjoitettu gdialog, MATE-siirros dialog-ohjelmasta, joka mahdollistaa valintalaatikoiden näyttämisen komentoriviltä ja kuoriskripteistä.</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>Johdanto</title>

    <para><application>MateDialog</application> mahdollistaa seuraavan tyyppisten yksinkertaisten ikkunoiden luomisen:</para>

    <itemizedlist>
        <listitem><para>Kalenteri</para></listitem>
	<listitem><para>Tiedoston valinta</para></listitem>
	<listitem><para>Luettelo</para></listitem>
	<listitem><para>Ilmoituskuvake</para></listitem>
        <listitem><para>Viesti</para>
            <itemizedlist>
	        <listitem><para>Virhe</para></listitem>
		<listitem><para>Tiedoksi</para></listitem>
		<listitem><para>Kysymys</para></listitem>
		<listitem><para>Varoitus</para></listitem>
	    </itemizedlist>
	</listitem>
	<listitem><para>Edistyminen</para></listitem>
        <listitem><para>Tekstisyöte</para></listitem>
	<listitem><para>Tekstihuomatus</para></listitem>
    </itemizedlist>

  </sect1>

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

  <sect1 id="matedialog-usage">
    <title>Käyttö</title>

    <para>Skriptejä kirjoitettaessa voi <application>MateDialogä</application> käyttää yksinkertaisten valintaikkunoiden luomiseen, jotka pyytävät käyttäjältä syötettä graafisesti, kuten seuraavissa tapauksissa:</para>
    <itemizedlist>
      <listitem>
        <para>Voit luoda valintaikkunan keräämään tietoa käyttäjältä. Voit esimerkiksi pyytää käyttäjää valitsemaan päivän kalenteri-ikkunasta tai valitsemaan tiedoston tiedoston valintaikkunalla.</para>
      </listitem>
      <listitem>
        <para>Voit luoda ikkunan, joka kertoo käyttäjälle tietoa. Voit esimerkiksi näyttää edistymisikkunassa operaation edistymisen tilanteen tai varoitusviesti-ikkunassa varoittaa käyttäjää.</para>
      </listitem>
    </itemizedlist>
    <para>Kun käyttäjä sulkee ikkunan, <application>MateDialog</application> tulostaa ikkunaan syötetyn tekstin vakiotulosteeseen.</para>

    <note>
      <para>Kun kirjoitat <application>MateDialog</application>-komentoja, ole tarkkana lainausmerkkien sijoittelussa jokaisen argumentin ympärillä.</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>Mikäli et käytä lainausmerkkejä, saatat saada odottamattomia tuloksia.</para>
    </note>

    <sect2 id="matedialog-usage-mnemonics">
      <title>Valintanäppäimet</title>
	<para>Valintanäppäin on näppäin, joka antaa mahdollisuuden suorittaa toiminto näppäimistöltä sen sijaan, että komento valittaisiin hiirellä valikosta tai ikkunasta. Jokainen valintanäppäin identifioidaan alleviivaamalla kirjain valikossa tai ikkunan kohdassa.</para>
	<para>Jotkut <application>MateDialog</application>-ikkunan tukevat valintanäppäinten käyttöä. Määrittääksesi kirjaimen valintanäppäimeksi, anna alaviiva ennen kirjainta ikkunan tekstissä. Seuraava esimerkki valaisee kuinka kirjain "V" määritetään valintanäppäimeksi:</para>
	<screen lang="en"><userinput>"_Choose a name".</userinput></screen>
    </sect2>

    <sect2 id="matedialog-usage-exitcodes">
      <title>Päättymiskoodit</title>
    <para><application>MateDialog</application> palauttaa seuraavia päättymiskoodeja:</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>Päättymiskoodi</para></entry>
            <entry colname="COLSPEC1">
              <para>Kuvaus</para></entry>
          </row>
        </thead>
        <tbody>
          <row valign="top">
            <entry>
              <para lang="en"><varname>0</varname></para>
            </entry>
            <entry>
              <para>Käyttäjä painoi joko <guibutton>OK</guibutton> tai <guibutton>Sulje</guibutton>.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>1</varname></para>
            </entry>
            <entry>
              <para>Käyttäjä painoi <guibutton>Peru</guibutton> tai käytti ikkunapainikkeita sulkemaan valintaikkunan.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>-1</varname></para>
            </entry>
            <entry>
              <para>Tapahtui odottamaton virhe.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>5</varname></para>
            </entry>
            <entry>
              <para>Ikkuna suljettiin aikarajan päätyttyä.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>

    </sect2>


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

  <sect2 id="matedialog-usage-general-options">
    <title>Yleiset valitsimet</title>

    <para>Kaikki <application>MateDialog</application>-ikkunat tukevat seuraavia yleisiä valitsimia:</para>

    <variablelist>

      <varlistentry>
        <term><option>--title</option>=<replaceable>otsikko</replaceable></term>
	<listitem>
	  <para>Määrittää ikkunan otsikon.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--window-icon</option>=<replaceable>kuvakepolku</replaceable></term>
	<listitem>
	  <para>Määrittää kuvakkeen, joka näytetään ikkunan kehyksessä. Saatavilla on myös neljä valmista kuvaketta, jotka saa käyttöön seuraavilla avainsanoilla - "info" (tietoa), "warning" (varoitus), "question" (kysymys) ja "error" (virhe).</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--width</option>=<replaceable>leveys</replaceable></term>
	<listitem>
	  <para>Määrittää ikkunan leveyden.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--height</option>=<replaceable>korkeus</replaceable></term>
	<listitem>
	  <para>Määrittää ikkunan korkeuden.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--timeout</option>=<replaceable>aikaraja</replaceable></term>
	<listitem>
	  <para>Määrittää aikarajan sekunteina, jonka jälkeen ikkuna suljetaan.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

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

  <sect2 id="matedialog-help-options">
    <title>Ohjevalitsimet</title>

    <para><application>MateDialog</application> tarjoaa seuraavat ohjevalitsimet:</para>

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--help</option></term>
	<listitem>
	  <para>Näyttää lyhennetyn ohjetekstin.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--help-all</option></term>
	<listitem>
	  <para>Näyttää täyden ohjetekstin kaikista ikkunatyypeistä.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-general</option></term>
	<listitem>
	  <para>Näyttää ohjetekstin yleisistä ikkunavalitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-calendar</option></term>
	<listitem>
	  <para>Näyttää ohjetekstin kalenteri-ikkunan valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-entry</option></term>
	<listitem>
	  <para>Näyttää ohjetekstin tekstisyöttöikkunan valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-error</option></term>
	<listitem>
	  <para>Näyttää ohjetekstin virheikkunan valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-info</option></term>
	<listitem>
	  <para>Näyttää ohjetekstin tietoikkunan valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-file-selection</option></term>
	<listitem>
	  <para>Näyttää ohjetekstin tiedoston valintaikkunan valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-list</option></term>
	<listitem>
	  <para>Näyttää ohjetekstin luetteloikkunan valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-notification</option></term>
	<listitem>
	  <para>Näyttää ohjetekstin ilmoituskuvakkeiden valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-progress</option></term>
	<listitem>
	  <para>Näyttää ohjetekstin edistymisikkunan valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-question</option></term>
	<listitem>
	  <para>Näyttää ohjetekstin kysymysikkunan valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-warning</option></term>
	<listitem>
	  <para>Näyttää ohjetekstin varoitusikkunan valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-text-info</option></term>
	<listitem>
	  <para>Näyttää ohjeen tietoikkunan valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-misc</option></term>
	<listitem>
	  <para>Näyttää ohjeen sekalaisista valitsimista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-gtk</option></term>
	<listitem>
	  <para>Näyttää ohjeen GTK+-valitsimista.</para>
	</listitem>
      </varlistentry>
 
    </variablelist>

  </sect2>

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

  <sect2 id="matedialog-miscellaneous-options">
    <title>Sekalaisia valitsimia</title>

    <para><application>MateDialog</application>llä on myös seuraavat sekalaiset valitsimet:</para>

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--about</option></term>
	<listitem>
	  <para>Näyttää <guilabel>Tietoja MateDialogstä</guilabel> -ikkunan, joka sisältää tiedot <application>MateDialog</application>n versiosta, tekijänoikeuksista ja kehittäjistä.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--version</option></term>
	<listitem>
	  <para>Näyttää <application>MateDialogn</application> versionumeron.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

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

  <sect2 id="matedialog-gtk-options">
    <title>GTK+-valitsimet</title>

    <para><application>MateDialog</application> tarjoaa tavanomaiset GTK+-valitsimet. Lisätietoa GTK+-valitsimista saa komennolla <command>matedialog -?</command>.</para>

  </sect2>

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

  <sect2 id="matedialog-environment-variables">
    <title>Ympäristömuuttujat</title>

    <para>Normaalisti <application>MateDialog</application> tunnistaa pääteikkunan, josta se on käynnistetty ja pitää itsensä tämän ikkunan päällä. Tämä käytös voidaan estää poistamalla <envar>WINDOWID</envar>-ympäristömuuttuja.</para>

  </sect2>

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

  <sect1 id="matedialog-calendar-options">
    <title>Kalenteri-ikkuna</title>

    <para>Käytä valitsinta <option>--calendar</option> luomaan kalenteri-ikkuna. <application>MateDialog</application> palauttaa valitun päivämäärään vakiotulosteeseen. Mikäli päivämäärää ei määritetty komentorivillä, ikkuna avataan sen hetkisen päivän kohdalta.</para>
    <para>Kalenteri-ikkuna tarjoaa seuraavat valitsimet:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>teksti</replaceable></term>
	<listitem>
	  <para>Määrittää tekstin, joka näkyy kalenteri-ikkunassa.</para>
	</listitem>
      </varlistentry>
     	
      <varlistentry>
        <term><option>--day</option>=<replaceable>päivä</replaceable></term>
	<listitem>
	  <para>Määrittää päivän, joka on aluksi valittuna kalenteri-ikkunassa. <replaceable>päivä</replaceable> tulee korvata numerolla 1—31.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--month</option>=<replaceable>kuukausi</replaceable></term>
	<listitem>
	  <para>Määrittää kuukauden, joka on aluksi valittuna kalenteri-ikkunassa. <replaceable>kuukausi</replaceable> tulee korvata numerolla 1—12.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--year</option>=<replaceable>vuosi</replaceable></term>
	<listitem>
	  <para>Määrittää vuoden, joka on aluksi valittuna kalenteri-ikkunassa.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--date-format</option>=<replaceable>muoto</replaceable></term>
	<listitem>
	  <para>Määrittää muotoilun, jossa kalenteri-ikkuna palauttaa päivämäärän valinnan jälkeen. Oletusmuotoilu riippuu maa-asetuksista. <replaceable>muoto</replaceable> täytyy koostua muotoilukoodeista, joita <command>strftime</command>-funktio hyväksyy, kuten <literal>%A %Y-%m-%d</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>Esimerkki kalenteri-ikkunasta</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>Tiedoston valintaikkuna</title>

    <para>Käytä valitsinta <option>--file-selection</option> luomaan tiedoston valintaikkuna. <application>MateDialog</application> palauttaa valitut tiedostot tai hakemistot vakiotulosteeseen. Oletusmoodi tiedoston valintaikkunalle on avaus.</para>
    <para>Tiedoston valintaikkuna tarjoaa seuraavat valitsimet:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>tiedostonimi</replaceable></term>
	<listitem>
	  <para>Määrittää tiedoston tai hakemiston, joka on aluksi ikkunan tullessa näkyviin valittuna tiedoston valintaikkunassa.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--multiple</option></term>
	<listitem>
	  <para>Sallii valita kerralla useamman tiedoston tiedoston valintaikkunassa.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--directory</option></term>
	<listitem>
	  <para>Sallii vain hakemistojen valitsemisen tiedoston valintaikkunassa.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--save</option></term>
	<listitem>
	  <para>Asettaa tiedoston valintaikkunan tallennustilaan.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--separator</option>=<replaceable>erotin</replaceable></term>
	<listitem>
	  <para>Määrittää merkkijonon, jota käytetään erottamaan tiedostot palautettavassa tiedostonimien luettelossa.</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>Esimerkki tiedoston valintaikkunasta</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>Ilmoituskuvake</title>

    <para>
    </para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>teksti</replaceable></term>
	<listitem>
	  <para>Määrittää tekstin, joka näkyy ilmoitusalueella.</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>Esimerkki ilmoituskuvakkeesta</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>Luetteloikkuna</title>

    <para>Käytä valitsinta <option>--list</option> luomaan luetteloikkuna. <application>MateDialog</application> palauttaa valittujen rivien ensimmäisten sarakkeiden tiedot vakiotulosteeseen.</para>

    <para>Ikkunan sisältö tulee määrittää sarake sarakkeelta ja rivi riviltä. Tiedot voidaan syöttää ikkunaan vakiosyötteen kautta. Jokainen tietue pitää erottaa rivinvaihtomerkillä. </para>

    <para>Mikäli käytössä on valitsin <option>--checklist</option> tai <option>--radiolist</option>, jokaisen rivin tulee alkaa joko 'TRUE' (tosi) tai 'FALSE' (epätosi).</para>

    <para>Luetteloikkuna tarjoaa seuraavat valitsimet:</para>

    <variablelist>

      <varlistentry>
        <term><option>--column</option>=<replaceable>sarake</replaceable></term>
	<listitem>
	  <para>Määrittää luetteloikkunassa näkyvien sarakkeiden otsakkeet. Määritä valitsin <option>--column</option> jokaiselle sarakkeelle, jonka haluat näkyvän ikkunassa.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--checklist</option></term>
	<listitem>
	  <para>Määrittää, että ensimmäinen sarake luetteloikkunassa sisältää valintaruutuja.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--radiolist</option></term>
	<listitem>
	  <para>Määrittää, että ensimmäinen sarake luetteloikkunassa sisältää radiovalitsimia.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
	<listitem>
	  <para>Sallii näytettävien tietuiden muokaamisen.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--separator</option>=<replaceable>erotin</replaceable></term>
	<listitem>
	  <para>Määrittää mitä merkkijonoa käytetään kun luetteloikkuna palauttaa valitut tietueet.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--print-column</option>=<replaceable>sarake</replaceable></term>
	<listitem>
	  <para>Määrittää mitkä sarakkeet tulostetaan valinnan jälkeen. Oletussarake on "1". "ALL" (kaikki) tarkoittaa, että kaikki luettelon sarakkeet tulostetaan.</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>Esimerkki luetteloikkunasta</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>Viesti-ikkunat</title>

    <para><application>MateDialog</application> voi luoda neljän tyyppisia viesti-ikkunoita:</para>
    <itemizedlist>
      <listitem>
        <para>Virhe</para>
      </listitem>
      <listitem>
        <para>Tiedoksi</para>
      </listitem>
      <listitem>
        <para>Kysymys</para>
      </listitem>
      <listitem>
        <para>Varoitus</para>
      </listitem>
    </itemizedlist>

    <para>Kaikille ikkunatyypeille valitsin <option>--text</option> määrittää ikkunassa näytettävän tekstin.</para>

    <sect2 id="matedialog-error-dialog">
      <title>Virheikkuna</title>

      <para>Käytä valitsinta <option>--error</option> luomaan virheikkuna.</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>Esimerkki virheikkunasta</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>Tietoikkuna</title>

      <para>Käytä valitsinta <option>--info</option> luomaan tietoikkuna.</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>Esimerkki tietoikkunasta</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>Kysymysikkuna</title>

      <para>Käytä valitsinta <option>--question</option> luomaan kysymysikkuna.</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>Esimerkki kysymysikkunasta</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>Varoitusikkuna</title>

      <para>Käytä valitsinta <option>--warning</option> luomaan varoitusikkuna.</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>Esimerkki varoitusikkunasta</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>Edistymisikkuna</title>

    <para>Käytä valitsinta <option>--progress</option> luomaan edistymisikkuna.</para>

    <para><application>MateDialog</application> lukee datan vakiosyötteestä rivi kerrallaan. Mikäli rivi alkaa #-merkillä, teksti päivitetään rivin tekstillä. Mikäli rivi sisältää vain numeron, edistymisprosentiksi päivitetään annettu numero.</para>
	
    <para>Edistymisikkuna tarjoaa seuraavat valitsimet:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>teksti</replaceable></term>
	<listitem>
	  <para>Määrittää tekstin, joka näytetään edistymisikkunassa.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--percentage</option>=<replaceable>prosentit</replaceable></term>
	<listitem>
	  <para>Määrittää prosentuaalisen osuuden alussa, joka asetetaan edistymisikkunaan.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--auto-close</option></term>
	<listitem>
	  <para>Edistymisikkuna suljetaan automaattisesti kun 100 % saavutetaan.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--pulsate</option></term>
	<listitem>
	  <para>Määrittää, että edistymisikkuna sykkii kunnes EOF-merkki (tiedoston loppumerkki) luetaan vakiosyötteestä.</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>Esimerkki edistymisikkunasta</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>Tekstinsyöttöikkuna</title>

    <para lang="en">
        Use the <option>--entry</option> option to create a text entry dialog. <application>MateDialog</application> returns the contents of the text entry to standard output. 
    </para>	
    <para>Tekstinsyöttöikkuna tarjoaa seuraavat valitsimet:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>teksti</replaceable></term>
	<listitem>
	  <para>Määrittää tekstin, joka näkyy tekstinsyöttöikkunassa.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--entry-text</option>=<replaceable>teksti</replaceable></term>
	<listitem>
	  <para>Määrittää tekstin, joka näytetään syöttökentässä teksinsyöttöikkunassa.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--hide-text</option></term>
	<listitem>
	  <para>Piilottaa tekstin syöttökentässä tekstinsyöttöikkunassa.</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>Esimerkki tekstinsyöttöikkunasta</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>Tekstitietoikkuna</title>

    <para>Käytä valitsinta <option>--text-info</option> luomaan tekstitietoikkuna.</para>
	
    <para>Tekstitietoikkuna tarjoaa seuraavat valitsimet:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>tiedostonimi</replaceable></term>
	<listitem>
	  <para>Määrittää tiedoston, joka ladataan tekstitietoikkunaan.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
        <listitem>
          <para>Sallii näytettävän tekstin muokkaamisen. Muokattu teksti palautetaan vakiotulosteeseen kun ikkuna suljetaan.</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>Esimerkki tekstilaatikkoikkunasta</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>
