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

  <articleinfo>
    <title>Handbok för MateDialog</title>
    <subtitle>Handbok för skrivbordsprogrammet MateDialog 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>Tillstånd att kopiera, distribuera och/eller modifiera detta dokument ges under villkoren i GNU Free Documentation License (GFDL), version 1.1 eller senare, utgivet av Free Software Foundation utan standardavsnitt och omslagstexter.  En kopia av GFDL finns att hämta på denna <ulink type="help" url="help:fdl">länk</ulink> eller i filen COPYING-DOCS som medföljer denna handbok.</para>
         <para>Denna handbok utgör en av flera MATE-handböcker som distribueras under villkoren i GFDL.  Om du vill distribuera denna handbok separat från övriga handböcker kan du göra detta genom att lägga till en kopia av licensavtalet i handboken enligt instruktionerna i avsnitt 6 i licensavtalet.</para>

	<para>Flera namn på produkter och tjänster är registrerade varumärken. I de fall dessa namn förekommer i MATE-dokumentation - och medlemmarna i MATE-dokumentationsprojektet är medvetna om dessa varumärken - är de skrivna med versaler eller med inledande versal.</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>Den här handboken beskriver version 2.6.0 av MateDialog.</releaseinfo>

    <legalnotice>
	    <title>Återkoppling</title>
	    <para>För att skicka in kommentarer eller förslag, följ instruktionerna på <ulink url="help:mate-feedback" type="help">återkopplingssidan</ulink>.</para>
<!-- Translators may also add here feedback address for translations -->

    </legalnotice>
    <abstract role="description">
            <para>MateDialog är en vidareutveckling av gdialog, MATE-porteringen av dialog som låter dig visa dialogrutor från kommandoraden och skalskript.</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>Introduktion</title>

    <para><application>MateDialog</application> låter dig skapa följande typer av enkla dialoger:</para>

    <itemizedlist>
        <listitem><para>Kalender</para></listitem>
	<listitem><para>Filval</para></listitem>
	<listitem><para>Lista</para></listitem>
	<listitem><para>Notifieringsikon</para></listitem>
        <listitem><para>Meddelande</para>
            <itemizedlist>
	        <listitem><para>Fel</para></listitem>
		<listitem><para>Information</para></listitem>
		<listitem><para>Fråga</para></listitem>
		<listitem><para>Varning</para></listitem>
	    </itemizedlist>
	</listitem>
	<listitem><para>Förlopp</para></listitem>
        <listitem><para>Textinmatning</para></listitem>
	<listitem><para>Textinformation</para></listitem>
    </itemizedlist>

  </sect1>

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

  <sect1 id="matedialog-usage">
    <title>Användning</title>

    <para>När du skriver skript kan du använda <application>MateDialog</application> för att skapa enkla dialogrutor som interagerar grafiskt med användaren. Här är några exempel:</para>
    <itemizedlist>
      <listitem>
        <para>Du kan skapa en dialogruta för att hämta in information från användaren. Till exempel kan du fråga användaren om att välja ett datum från en kalenderdialog, eller att välja en fil från en filväljardialog.</para>
      </listitem>
      <listitem>
        <para>Du kan skapa en dialogruta för att tillhandahålla information till användaren. Till exempel kan du använda en förloppsdialog för att indikera aktuell status för en åtgärd, eller använda en varningsdialog för att larma användaren.</para>
      </listitem>
    </itemizedlist>
    <para lang="en">
	When the user closes the dialog, <application>MateDialog</application> prints the text produced by the dialog to standard output.
    </para>

    <note>
      <para>Var noga med att skriva citationstecken runt varje argument när du skriver <application>MateDialog</application>-kommandon.</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>Om du inte använder citationstecken kan du få oväntade resultat.</para>
    </note>

    <sect2 id="matedialog-usage-mnemonics">
      <title>Snabbtangenter</title>
	<para>En snabbtangent är en tangent som låter dig genomföra en åtgärd från tangentbordet istället för att använda musen för att välja ett kommando från en meny eller dialog. Varje snabbtangent identifieras av en understruken bokstav i en meny eller dialogflagga.</para>
	<para>Vissa dialoger i <application>MateDialog</application> har stöd för användningen av snabbtangenter. För att specificera tecknet som ska användas som snabbtangenten, placera ett understreck före den bokstaven i dialogens text. Följande exempel visar hur man specificerar bokstaven "V" som en snabbtangent:</para>
	<screen lang="en"><userinput>"_Choose a name".</userinput></screen>
    </sect2>

    <sect2 id="matedialog-usage-exitcodes">
      <title>Avslutningskoder</title>
    <para><application>MateDialog</application> returnerar följande avslutningskoder:</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>Avslutningskod</para></entry>
            <entry colname="COLSPEC1">
              <para>Beskrivning</para></entry>
          </row>
        </thead>
        <tbody>
          <row valign="top">
            <entry>
              <para lang="en"><varname>0</varname></para>
            </entry>
            <entry>
              <para>Användaren har antingen tryckt på <guibutton>OK</guibutton> eller <guibutton>Stäng</guibutton>.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>1</varname></para>
            </entry>
            <entry>
              <para>Användaren har antingen tryckt på <guibutton>Avbryt</guibutton>, eller använt fönsterfunktioner för att stänga dialogrutan.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>-1</varname></para>
            </entry>
            <entry>
              <para>Ett oväntat fel har inträffat.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>5</varname></para>
            </entry>
            <entry>
              <para>Dialogrutan har stängts därför att tidsgränsen har nåtts.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>

    </sect2>


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

  <sect2 id="matedialog-usage-general-options">
    <title>Allmänna alternativ</title>

    <para>Alla dialoger i <application>MateDialog</application> har stöd för följande allmänna flaggor:</para>

    <variablelist>

      <varlistentry>
        <term><option>--title</option>=<replaceable>titel</replaceable></term>
	<listitem>
	  <para>Anger titeln på en dialogruta.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--window-icon</option>=<replaceable>ikonsökväg</replaceable></term>
	<listitem>
	  <para>Anger ikonen som visas i fönsterramen för dialogen. Det finns 4 standardikoner som finns tillgängliga genom att ange något av följande nyckelord - "info", "warning", "question" och "error".</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--width</option>=<replaceable>bredd</replaceable></term>
	<listitem>
	  <para>Anger bredden på dialogrutan.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--height</option>=<replaceable>höjd</replaceable></term>
	<listitem>
	  <para>Anger höjden på dialogrutan.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--timeout</option>=<replaceable>tidsgräns</replaceable></term>
	<listitem>
	  <para>Anger tidsgränsen i sekunder efter vilken dialogrutan stängs.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

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

  <sect2 id="matedialog-help-options">
    <title>Hjälpflaggor</title>

    <para><application>MateDialog</application> tillhandahåller följande hjälpflaggor:</para>

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--help</option></term>
	<listitem>
	  <para>Visar förkortad hjälptext.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--help-all</option></term>
	<listitem>
	  <para>Visar fullständig hjälptext för alla dialoger.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-general</option></term>
	<listitem>
	  <para>Visar hjälptext för allmänna dialogflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-calendar</option></term>
	<listitem>
	  <para>Visar hjälptext för kalenderdialogflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-entry</option></term>
	<listitem>
	  <para>Visar hjälptext för textinmatningsdialogflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-error</option></term>
	<listitem>
	  <para>Visar hjälptext för feldialogflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-info</option></term>
	<listitem>
	  <para>Visar hjälptext för informationsdialogflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-file-selection</option></term>
	<listitem>
	  <para>Visar hjälptext för filväljardialogflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-list</option></term>
	<listitem>
	  <para>Visar hjälptext för listdialogflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-notification</option></term>
	<listitem>
	  <para>Visar hjälptext för notifieringsikonflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-progress</option></term>
	<listitem>
	  <para>Visar hjälptext för förloppsdialogflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-question</option></term>
	<listitem>
	  <para>Visar hjälptext för frågedialogflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-warning</option></term>
	<listitem>
	  <para>Visar hjälptext för varningsdialogflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-text-info</option></term>
	<listitem>
	  <para>Visar hjälp för textinformationsdialogflaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-misc</option></term>
	<listitem>
	  <para>Visar hjälp för diverse flaggor.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-gtk</option></term>
	<listitem>
	  <para>Visar hjälp för GTK+-flaggor.</para>
	</listitem>
      </varlistentry>
 
    </variablelist>

  </sect2>

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

  <sect2 id="matedialog-miscellaneous-options">
    <title>Diverse flaggor</title>

    <para><application>MateDialog</application> tillhandahåller även följande diverse flaggor:</para>

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--about</option></term>
	<listitem>
	  <para>Visar dialogrutan <guilabel>Om MateDialog</guilabel>, vilken innehåller versionsinformation, copyrightinformation, och utvecklarinformation om <application>MateDialog</application>.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--version</option></term>
	<listitem>
	  <para>Visar versionsnumret för <application>MateDialog</application>.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

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

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

    <para><application>MateDialog</application> har stöd för standard-GTK+-flaggor. För mer information om GTK+-flaggorna, kör kommandot <command>matedialog -?</command>.</para>

  </sect2>

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

  <sect2 id="matedialog-environment-variables">
    <title lang="en">Environment Variables</title>

    <para lang="en">
      Normally, <application>MateDialog</application> detects the terminal window from which it was launched
      and keeps itself above that window.  This behavior can be disabled by
      unsetting the <envar>WINDOWID</envar> environment variable.
    </para>

  </sect2>

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

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

    <para lang="en">
        Use the <option>--calendar</option> option to create a calendar dialog. <application>MateDialog</application> returns the selected date to standard output. If no date is specified on the command line, the dialog uses the current date.
    </para>
    <para>Kalenderdialogen har stöd för följande flaggor:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Anger texten som visas i kalenderdialogen.</para>
	</listitem>
      </varlistentry>
     	
      <varlistentry>
        <term><option>--day</option>=<replaceable>dag</replaceable></term>
	<listitem>
	  <para>Anger dagen som är markerad i kalenderdialogen. <replaceable>dag</replaceable> måste vara ett tal mellan 1 och 31.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--month</option>=<replaceable>månad</replaceable></term>
	<listitem>
	  <para>Anger månaden som är markerad i kalenderdialogen. <replaceable>månad</replaceable> måste vara ett tal mellan 1 och 12.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--year</option>=<replaceable>år</replaceable></term>
	<listitem>
	  <para>Anger året som är markerat i kalenderdialogen.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--date-format</option>=<replaceable>format</replaceable></term>
	<listitem>
	  <para>Anger formatet som returneras från kalenderdialogen efter en datummarkering. Standardformatet beror på din lokalinställning. <replaceable>format</replaceable> måste vara ett format som är acceptabelt för funktionen <command>strftime</command>, till exempel <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>Exempel på kalenderdialog</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>Filväljardialog</title>

    <para lang="en">
	Use the <option>--file-selection</option> option to create a file selection dialog. <application>MateDialog</application> returns the selected files or directories to standard 
        output. The default mode of the file selection dialog is open.
    </para>
    <para>Filväljardialogen har stöd för följande flaggor:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>filnamn</replaceable></term>
	<listitem>
	  <para>Anger filen eller katalogen som är markerad i filväljardialogen när dialogen först visas.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--multiple</option></term>
	<listitem>
	  <para>Tillåter markering av flera filnamn i filväljardialogen.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--directory</option></term>
	<listitem>
	  <para>Tillåter endast markering av kataloger i filväljardialogen.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--save</option></term>
	<listitem>
	  <para>Ställ in filväljardialogen till sparningsläge.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--separator</option>=<replaceable>avgränsare</replaceable></term>
	<listitem>
	  <para>Anger strängen som används för att avgränsa den returnerade listan över filnamn.</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>Exempel på filväljardialog</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>Notifieringsikon</title>

    <para>
    </para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Anger texten som visas i notifieringsytan.</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>Exempel på notifieringsikon</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>Listdialog</title>

    <para lang="en">
	Use the <option>--list</option> option to create a list dialog. <application>MateDialog</application> returns the entries in the first column of text of selected rows to standard output.
    </para>

    <para>Data för dialogen måste anges kolumn för kolumn, rad för rad. Data kan tillhandahållas till dialogen genom standard in. Varje post måste separeras med ett nyradstecken.</para>

    <para>Om du använder flaggorna <option>--checklist</option> eller <option>--radiolist</option>, måste varje rad börja med antingen "TRUE" eller "FALSE".</para>

    <para>Listdialogen har stöd för följande flaggor:</para>

    <variablelist>

      <varlistentry>
        <term><option>--column</option>=<replaceable>kolumn</replaceable></term>
	<listitem>
	  <para>Anger kolumnhuvuden som visas i listdialogen. Du måste ange flaggan <option>--column</option> för varje kolumn som du vill visa i dialogen.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--checklist</option></term>
	<listitem>
	  <para>Anger att den första kolumnen i listdialogen innehåller kryssrutor.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--radiolist</option></term>
	<listitem>
	  <para>Anger att första kolumnen i listdialogen innehåller radioknappar.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
	<listitem>
	  <para>Tillåter att de visade posterna kan redigeras.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--separator</option>=<replaceable>avgränsare</replaceable></term>
	<listitem>
	  <para>Anger vilken sträng som används när listdialogen returnerar de markerade posterna.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--print-column</option>=<replaceable>kolumn</replaceable></term>
	<listitem>
	  <para>Anger vilken kolumn som ska skrivas ut vid markering. Standardkolumnen är "1". "ALL" kan användas för att skriva ut alla kolumner i listan.</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>Exempel på listdialog</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>Meddelandedialoger</title>

    <para><application>MateDialog</application> kan skapa fyra typer av meddelandedialoger:</para>
    <itemizedlist>
      <listitem>
        <para>Fel</para>
      </listitem>
      <listitem>
        <para>Information</para>
      </listitem>
      <listitem>
        <para>Fråga</para>
      </listitem>
      <listitem>
        <para>Varning</para>
      </listitem>
    </itemizedlist>

    <para>För varje typ, använd flaggan <option>--text</option> för att ange texten som visas i dialogrutan.</para>

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

      <para>Använd flaggan <option>--error</option> för att skapa en feldialog.</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>Exempel på feldialog</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>Informationsdialog</title>

      <para>Använd flaggan <option>--info</option> för att skapa en informationsdialog.</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>Exempel på informationsdialog</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>Frågedialog</title>

      <para>Använd flaggan <option>--question</option> för att skapa en frågedialog.</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>Exempel på frågedialog</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>Varningsdialog</title>

      <para>Använd flaggan <option>--warning</option> för att skapa en varningsdialog.</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>Exempel på varningsdialog</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>Förloppsdialog</title>

    <para>Använd flaggan <option>--progress</option> för att skapa en förloppsdialog.</para>

    <para><application>MateDialog</application> läser data rad för rad från standard in. Om en rad inleds med #, kommer texten att uppdateras med texten på den raden. Om en rad endast innehåller en siffra, kommer procenttalet att uppdateras med det talet.</para>
	
    <para>Förloppsdialogen har stöd för följande flaggor:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Anger texten som visas i förloppsdialogen.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--percentage</option>=<replaceable>procenttal</replaceable></term>
	<listitem>
	  <para>Anger den initiala procenttalet som är inställt i förloppsdialogen.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--auto-close</option></term>
	<listitem>
	  <para>Stänger förloppsdialogen när 100% har nåtts.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--pulsate</option></term>
	<listitem>
	  <para>Anger att förloppsmätaren pulserar tills ett EOF-tecken läses in från standard in.</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>Exempel på förloppsdialog</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>Textinmatningsdialog</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>Textinmatningsdialogen har stöd för följande flaggor:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Anger texten som visas i textinmatningsdialogen.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--entry-text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Anger texten som visas i inmatningsfältet för textinmatningsdialogen.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--hide-text</option></term>
	<listitem>
	  <para>Döljer texten i inmatningsfältet för textinmatningsdialogen.</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>Exempel på textinmatningsdialog</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>Textinformationsdialog</title>

    <para>Använd flaggan <option>--text-info</option> för att skapa en textinformationsdialog.</para>
	
    <para>Textinformationsdialogen har stöd för följande flaggor:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>filnamn</replaceable></term>
	<listitem>
	  <para>Anger en fil som läses in i textinformationsdialogen.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
        <listitem>
          <para lang="en">Allows the displayed text to be edited. The edited text is returned to standard output when the dialog is closed.</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>Exempel på textinformationsdialog</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>
