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

  <articleinfo>
    <title>MateDialog-Handbuch</title>
    <subtitle>MateDialog-Desktop-Anwenderhandbuch 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>Das vorliegende Dokument kann gemäß den Bedingungen der GNU Free Documentation License (GFDL), Version 1.1 oder jeder späteren, von der Free Software Foundation veröffentlichten Version ohne unveränderbare Abschnitte sowie ohne Texte auf dem vorderen und hinteren Buchdeckel kopiert, verteilt und/oder modifiziert werden. Eine Kopie der GFDL finden Sie unter diesem <ulink type="help" url="help:fdl">Link</ulink> oder in der mit diesem Handbuch gelieferten Datei COPYING-DOCS.</para>
         <para>Dieses Handbuch ist Teil einer Sammlung von MATE-Handbüchern, die unter der GFDL veröffentlicht werden. Wenn Sie dieses Handbuch getrennt von der Sammlung weiterverbreiten möchten, können Sie das tun, indem Sie eine Kopie der Lizenz zum Handbuch hinzufügen, wie es in Abschnitt 6 der Lizenz beschrieben ist.</para>

	<para>Viele der Namen, die von Unternehmen verwendet werden, um ihre Produkte und Dienstleistungen von anderen zu unterscheiden, sind eingetragene Warenzeichen. An den Stellen, an denen diese Namen in einer MATE-Dokumentation erscheinen, werden die Namen in Großbuchstaben oder mit einem großen Anfangsbuchstaben geschrieben, wenn das MATE-Dokumentationsprojekt auf diese Warenzeichen hingewiesen wird.</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>Dieses Handbuch beschreibt Version 2.6.0 von MateDialog.</releaseinfo>

    <legalnotice>
	    <title>Rückmeldungen</title>
	    <para>Zum Senden von Rückmeldungen folgen Sie den Anweisungen auf der <ulink url="help:mate-feedback" type="help">MATE-Seite für Rückmeldungen</ulink>.</para>
<!-- Translators may also add here feedback address for translations -->

    </legalnotice>
    <abstract role="description">
            <para>MateDialog entstand aus »gdialog«, der MATE-Variante von »dialog«, welches Ihnen erlaubt, Dialogfenster über die Befehlszeile und mittels Shell-Skripten anzuzeigen.</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>Einführung</title>

    <para><application>MateDialog</application> erlaubt Ihnen die Erzeugung der folgenden Typen simpler Dialoge:</para>

    <itemizedlist>
        <listitem><para>Kalender</para></listitem>
	<listitem><para>Dateiauswahl</para></listitem>
	<listitem><para>Liste</para></listitem>
	<listitem><para>Benachrichtigungssymbol</para></listitem>
        <listitem><para>Meldung</para>
            <itemizedlist>
	        <listitem><para>Fehler</para></listitem>
		<listitem><para>Information</para></listitem>
		<listitem><para>Frage</para></listitem>
		<listitem><para>Warnung</para></listitem>
	    </itemizedlist>
	</listitem>
	<listitem><para>Fortschritt</para></listitem>
        <listitem><para>Textfeld</para></listitem>
	<listitem><para>Textinformation</para></listitem>
    </itemizedlist>

  </sect1>

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

  <sect1 id="matedialog-usage">
    <title>Benutzung</title>

    <para>Wenn Sie Skripte schreiben, können Sie <application>MateDialog</application> zur Erzeugung einfacher Dialoge zur Interaktion mit dem Benutzer verwenden, wie folgende:</para>
    <itemizedlist>
      <listitem>
        <para>Sie können einen Dialog erzeugen, der die Eingabe von Informationen durch den Benutzer erfordert. Beispielsweise können Sie den Benutzer anweisen, ein Datum aus einem Kalenderdialog oder eine Datei aus einem Dateiauswahldialog zu wählen.</para>
      </listitem>
      <listitem>
        <para>Sie können einen Dialog erzeugen, um dem Benutzer Informationen zur Verfügung zu stellen. Beispielsweise können Sie einen Fortschrittsanzeige-Dialog erzeugen, um auf den aktuellen Status eines Vorgangs hinzuweisen, oder einen Warndialog, um den Benutzer zu warnen.</para>
      </listitem>
    </itemizedlist>
    <para>Wenn der Benutzer den Dialog schließt, schreibt <application>MateDialog</application> den vom Dialog ausgegebenen Text in die Standardausgabe.</para>

    <note>
      <para>Wenn Sie <application>MateDialog</application>-Befehle schreiben, stellen Sie bitte sicher, dass Sie jedes Argument stets in Anführungszeichen einschließen.</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>Wenn Sie keine Anführungszeichen verwenden, könnten Sie unerwartete Ergebnisse erhalten.</para>
    </note>

    <sect2 id="matedialog-usage-mnemonics">
      <title>Zugriffstasten</title>
	<para>Eine Zugriffstaste ist eine Taste, die Ihnen die Ausführung einer Aktion mit der Tastatur zur Auswahl eines Befehls aus einem Menü oder einem Dialog erlaubt, anstatt dafür die Maus zu benutzen.</para>
	<para>Einige <application>MateDialog</application>-Dialoge unterstützen die Verwendung von Zugriffstasten. Um das Zeichen für den Tastaturzugriff festzulegen, setzen Sie einen Unterstrich vor das Zeichen im Dialogtext. Das folgende Beispiel zeigt, wie Sie den Buchstaben »W« als Zugriffstaste festlegen.</para>
	<screen lang="en"><userinput>"_Choose a name".</userinput></screen>
    </sect2>

    <sect2 id="matedialog-usage-exitcodes">
      <title>Rückgabewerte</title>
    <para><application>MateDialog</application> erzeugt die folgenden Rückgabewerte:</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>Rückgabewert</para></entry>
            <entry colname="COLSPEC1">
              <para>Beschreibung</para></entry>
          </row>
        </thead>
        <tbody>
          <row valign="top">
            <entry>
              <para lang="en"><varname>0</varname></para>
            </entry>
            <entry>
              <para>Der Benutzer hat entweder auf <guibutton>OK</guibutton> oder auf <guibutton>Schließen</guibutton> gedrückt.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>1</varname></para>
            </entry>
            <entry>
              <para>Der Benutzer hat entweder auf <guibutton>Abbrechen</guibutton> gedrückt oder die Fensterfunktionen zum Schließen des Dialogs benutzt.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>-1</varname></para>
            </entry>
            <entry>
              <para>Es ist ein unerwarteter Fehler aufgetreten.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>5</varname></para>
            </entry>
            <entry>
              <para>Der Dialog wurde geschlossen, weil die Wartezeit verstrichen ist.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>

    </sect2>


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

  <sect2 id="matedialog-usage-general-options">
    <title>Allgemeine Einstellungen</title>

    <para>Alle <application>MateDialog</application>-Dialoge unterstützen die folgenden allgemeinen Optionen:</para>

    <variablelist>

      <varlistentry>
        <term><option>--title</option>=<replaceable>Titel</replaceable></term>
	<listitem>
	  <para>Damit legen Sie den Titel des Dialogs fest.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--window-icon</option>=<replaceable>Symbolpfad</replaceable></term>
	<listitem>
	  <para>Damit legen Sie das Symbol fest, das im Fensterrahmen des Dialogs angezeigt wird. Es gibt 4 Standardsymbole, die auch über die Schlüsselwörter »info«, »warning«, »question« und »error« bereitgestellt werden.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--width</option>=<replaceable>Breite</replaceable></term>
	<listitem>
	  <para>Damit legen Sie die Breite des Dialogs fest.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--height</option>=<replaceable>Höhe</replaceable></term>
	<listitem>
	  <para>Damit legen Sie die Höhe des Dialogs fest.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--timeout</option>=<replaceable>timeout</replaceable></term>
	<listitem>
	  <para>Damit legen Sie die Wartezeit in Sekunden bis zum Schließen des Dialogs fest.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

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

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

    <para><application>MateDialog</application> stellt die folgenden Hilfeoptionen bereit:</para>

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--help</option></term>
	<listitem>
	  <para>Damit zeigen Sie einen Hilfetext in Kurzform an.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--help-all</option></term>
	<listitem>
	  <para>Damit zeigen Sie den kompletten Hilfetext für alle Dialoge an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-general</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für allgemeine Dialogoptionen an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-calendar</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für Kalenderdialogoptionen an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-entry</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für Optionen des Texteingabedialogs an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-error</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für Optionen des Fehlerdialogs an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-info</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für Informationsdialogoptionen an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-file-selection</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für Optionen des Dateiauswahldialogs.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-list</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für Optionen des Listendialogs an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-notification</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für Optionen des Benachrichtigungsymbols an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-progress</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für Optionen des Fortschrittsanzeige-Dialogs an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-question</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für Optionen des Fragedialogs an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-warning</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für die Optionen des Warndialogs an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-text-info</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für Optionen des Informationsdialogs an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-misc</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für nicht auf einen bestimmten Dialog bezogene Optionen an.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-gtk</option></term>
	<listitem>
	  <para>Damit zeigen Sie den Hilfetext für die GTK+-Optionen an.</para>
	</listitem>
      </varlistentry>
 
    </variablelist>

  </sect2>

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

  <sect2 id="matedialog-miscellaneous-options">
    <title>Verschiedene Optionen</title>

    <para><application>MateDialog</application> stellt außerdem die folgenden verschiedenen Optionen zur Verfügung:</para>

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--about</option></term>
	<listitem>
	  <para>Damit zeigen Sie den <guilabel>Info zu MateDialog</guilabel>-Dialog an, der Versionsinformationen, Copyright-Informationen und Entwicklerinformationen über <application>MateDialog</application> enthält.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--version</option></term>
	<listitem>
	  <para>Damit zeigen Sie die Versionsnummer von <application>MateDialog</application> an.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

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

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

    <para><application>MateDialog</application> unterstützt die Standardoptionen von GTK+. Um weitere Informationen über die GTK+-Optionen anzuzeigen, führen Sie den Befehl <command>matedialog -?</command> aus.</para>

  </sect2>

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

  <sect2 id="matedialog-environment-variables">
    <title>Umgebungsvariablen</title>

    <para>Normalerweise erkennt <application>MateDialog</application> das Terminalfenster, aus dem es gestartet wurde und hält sein eigenes Fenster im Vordergrund dieses Fensters. Dieses Verhalten kann deaktiviert werden, wenn Sie das Setzen der Umgebungsvariable <envar>WINDOWID</envar> deaktivieren.</para>

  </sect2>

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

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

    <para>Benutzen Sie die Option <option>--calendar</option> zur Erzeugung eines Kalenderdialogs. <application>MateDialog</application> gibt das gewählte Datum an die Standardausgabe zurück. Wenn kein Datum auf der Befehlszeile angegeben wird, verwendet der Dialog das aktuelle Datum.</para>
    <para>Der Kalenderdialog unterstützt die folgenden Optionen:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>Text</replaceable></term>
	<listitem>
	  <para>Damit legen Sie den Text fest, der im Kalenderdialog angezeigt wird.</para>
	</listitem>
      </varlistentry>
     	
      <varlistentry>
        <term><option>--day</option>=<replaceable>Tag</replaceable></term>
	<listitem>
	  <para>Damit legen Sie den im Kalenderdialog ausgewählten Tag fest. <replaceable>Tag</replaceable> muss eine Zahl von 1 bis 31 sein.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--month</option>=<replaceable>Monat</replaceable></term>
	<listitem>
	  <para>Damit legen Sie den im Kalenderdialog ausgewählten Monat fest. <replaceable>Monat</replaceable> muss eine Zahl zwischen 1 und 12 sein.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--year</option>=<replaceable>Jahr</replaceable></term>
	<listitem>
	  <para>Damit legen Sie das im Kalenderdialog ausgewählte Jahr fest.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--date-format</option>=<replaceable>Format</replaceable></term>
	<listitem>
	  <para>Damit legen Sie das Format fest, das vom Kalenderdialog nach der Auswahl des Datums zurückgegeben wird. Das Standardformat ist abhängig von Ihren Spracheinstellungen. <replaceable>Format</replaceable> muss ein Format sein, das von der <command>strftime</command>-Funktion unterstützt wird, zum Beispiel <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>Beispiel für einen 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>Dateiauswahldialog</title>

    <para>Verwenden Sie die Option <option>--file-selection</option> zur Erzeugung eines Dateiauswahldialogs. <application>MateDialog</application> gibt die ausgewählten Dateien oder Ordner an die Standardausgabe zurück. Der Standardmodus für den Dateiauswahldialog ist »Öffnen«. </para>
    <para>Der Dateiauswahldialog unterstützt die folgenden Optionen:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>Dateiname</replaceable></term>
	<listitem>
	  <para>Legt die Datei oder den Ordner fest, die oder der bei der ersten Anzeige des Dateiauswahldialogs angezeigt wird.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--multiple</option></term>
	<listitem>
	  <para>Erlaubt die Mehrfachauswahl von Dateien im Dateiauswahldialog.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--directory</option></term>
	<listitem>
	  <para>Erlaubt nur die Auswahl von Ordnern im Dateiauswahldialog.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--save</option></term>
	<listitem>
	  <para>Setzt den Dateiauswahldialog in den Modus »Speichern«.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--separator</option>=<replaceable>Trenner</replaceable></term>
	<listitem>
	  <para>Legt die Zeichenkette fest, die für die Trennung der zurückgegebenen Liste der Dateinamen verwendet wird.</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>Beispiel für einen Dateiauswahldialog</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>Benachrichtigungssymbol</title>

    <para>
    </para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>Text</replaceable></term>
	<listitem>
	  <para>Legt den Text fest, der im Benachrichtigungsfeld angezeigt wird.</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>Beispiel für ein Benachrichtigungssymbol</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>Listendialog</title>

    <para>Verwenden Sie die Option <option>--list</option>, um einen Listendialog zu erzeugen. <application>MateDialog</application> gibt die Einträge in der ersten Spalte der ausgewählten Zeile an die Standardausgabe zurück.</para>

    <para>Die Daten für den Dialog müssen Spalte für Spalte und Zeile für Zeile angegeben werden. Die Daten können dem Dialog durch die Standardeingabe zur Verfügung gestellt werden. Die einzelnen Einträge müssen durch ein Newline-Zeichen voneinander getrennt werden.</para>

    <para>Wenn Sie die Optionen <option>--checklist</option> oder <option>--radiolist</option> verwenden, muss jede Zeile entweder mit 'TRUE' oder mit 'FALSE' beginnen.</para>

    <para>Der Listendialog unterstützt die folgenden Optionen:</para>

    <variablelist>

      <varlistentry>
        <term><option>--column</option>=<replaceable>Spalte</replaceable></term>
	<listitem>
	  <para>Legt die Spaltenüberschriften fest, die im Listendialog angezeigt werden sollen. Sie müssen eine <option>--column</option>-Option für jede Spalte angeben, die Sie im Listendialog anzeigen wollen.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--checklist</option></term>
	<listitem>
	  <para>Legt fest, dass die erste Spalte im Listendialog Ankreuzfelder enthält.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--radiolist</option></term>
	<listitem>
	  <para>Legt fest, dass die erste Spalte im Listendialog Radioknöpfe enthalten soll.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
	<listitem>
	  <para>Erlaubt die Bearbeitung der angezeigten Objekte.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--separator</option>=<replaceable>Trenner</replaceable></term>
	<listitem>
	  <para>Legt fest, welche Zeichenkette verwendet wird, wenn der Listendialog die ausgewählten Einträge zurück gibt.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--print-column</option>=<replaceable>Spalte</replaceable></term>
	<listitem>
	  <para>Dies legt fest, welche Spalte Ihrer Auswahl ausgegeben werden soll. Die Vorgabe ist »1«. Sie können »ALL« verwenden, um alle Spalten der Liste ausgeben zu lassen.</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>Beispiel für einen Listendialog</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>Meldungsdialoge</title>

    <para><application>MateDialog</application> kann vier verschiedene Typen von Meldungsdialogen erzeugen:</para>
    <itemizedlist>
      <listitem>
        <para>Fehler</para>
      </listitem>
      <listitem>
        <para>Information</para>
      </listitem>
      <listitem>
        <para>Frage</para>
      </listitem>
      <listitem>
        <para>Warnung</para>
      </listitem>
    </itemizedlist>

    <para>Für jeden dieser Typen geben Sie mit der Option <option>--text</option> an, welcher Text im Dialog angezeigt werden soll.</para>

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

      <para>Verwenden Sie die Option <option>--error</option>, um einen Fehlerdialog zu erzeugen.</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>Beispiel für einen Fehlerdialog</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>Verwenden Sie die Option <option>--info</option>, um einen Informationsdialog zu erzeugen.</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>Beispiel für einen 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>Fragedialog</title>

      <para>Verwenden Sie die Option <option>--question</option>, um einen Fragedialog zu erzeugen.</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>Beispiel für einen Fragedialog</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>Warndialog</title>

      <para>Verwenden Sie die Option <option>--warning</option>, um einen Warndialog zu erzeugen.</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>Beispiel für einen Warndialog</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>Fortschrittsanzeige-Dialog</title>

    <para>Verwenden Sie die Option <option>--progress</option>, um einen Fortschrittsanzeige-Dialog zu erzeugen.</para>

    <para><application>MateDialog</application> liest die Daten aus der Standardeingabe zeilenweise. Wenn einer Zeile ein Raute-Zeichen (#) vorangestellt ist, wird der angezeigte Text durch den Text in dieser Zeile aktualisiert, bei einem angezeigten Prozentsatz durch die angegebene Zahl.</para>
	
    <para>Der Fortschrittsanzeige-Dialog unterstützt die folgenden Optionen:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>Text</replaceable></term>
	<listitem>
	  <para>Legt den Text fest, der im Fortschrittsanzeige-Dialog angezeigt wird.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--percentage</option>=<replaceable>Prozentsatz</replaceable></term>
	<listitem>
	  <para>Legt den anfänglich im Fortschrittsanzeige-Dialog angezeigten Prozentsatz fest.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--auto-close</option></term>
	<listitem>
	  <para>Schließt den Fortschrittsanzeige-Dialog, wenn 100% erreicht sind.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--pulsate</option></term>
	<listitem>
	  <para>Legt fest, dass die Fortschrittsleiste pulsiert, bis ein EOF-Zeichen von der Standardeingabe gelesen wird.</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>Beispiel für einen Fortschrittsanzeige-Dialog</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>Texteingabe-Dialog</title>

    <para>Verwenden Sie die Option <option>--entry</option>, um einen Texteingabedialog zu erzeugen. <application>MateDialog</application> gibt den Inhalt des Texts an die Standardausgabe zurück.</para>	
    <para>Der Texteingabedialog unterstützt die folgenden Optionen:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>Text</replaceable></term>
	<listitem>
	  <para>Legt den Text fest, der im Texteingabedialog angezeigt wird.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--entry-text</option>=<replaceable>Text</replaceable></term>
	<listitem>
	  <para>Legt den Text fest, der im Eingabefeld des Texteingabedialogs angezeigt wird.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--hide-text</option></term>
	<listitem>
	  <para>Dadurch wird der Text im Eingabefeld des Textreingabedialogs verborgen.</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>Beispiel für einen Texteingabe-Dialog</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>Text-Informationsdialog</title>

    <para>Verwenden Sie die Option <option>--text-info</option>, um einen Textinformationsdialog zu erzeugen.</para>
	
    <para>Der Textinformationsdialog unterstützt die folgenden Optionen:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>Dateiname</replaceable></term>
	<listitem>
	  <para>Legt eine Datei fest, die im Textinformationsdialog geladen wird.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
        <listitem>
          <para>Ermöglicht die Bearbeitung des angezeigten Texts. Der bearbeitete Text wird an die Standardausgabe zurückgegeben, wenn der Dialog geschlossen wird.</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>Beispiel für einen Text-Informationsdialog</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>
