<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="usage" xml:lang="da">
<info>
  <link type="guide" xref="index"/>
  <desc>You can use <app>Zenity</app> to create simple dialogs that interact graphically with the user.</desc>
</info>
<title>Brug</title>
    <p>
	When you write scripts, you can use <app>Zenity</app> to create simple dialogs that interact graphically with the user, as follows:
    </p>
    <list>
      <item>
        <p>Du kan oprette et dialogvindue for at indhente information fra brugeren. For eksempel kan du bede brugeren om at vælge en dato fra et kalendervindue, eller om at vælge en fil fra en filvælger.</p>
      </item>
      <item>
        <p>Du kan oprette et dialogvindue for at vise information til brugeren. For eksempel kan du bruge en statusbjælke til at angive status for en operation, eller vise en advarsel til brugeren.</p>
      </item>
    </list>
    <p>
	When the user closes the dialog, <app>Zenity</app> prints the text produced by the dialog to standard output.
    </p>

    <note>
      <p>
        When you write <app>Zenity</app> commands, ensure that you place quotation marks around each argument. 
      </p>
      <p>For example, use:</p>
      <screen>zenity --calendar --title="Holiday Planner"</screen>
      <p>Do not use:</p>
      <screen>zenity --calendar --title=Holiday Planner</screen>
      <p>Hvis du ikke bruger anførselstegn, kan du få uventede resultater.</p>
    </note>

    <section id="zenity-usage-mnemonics">
      <title>Genvejstaster</title>
	<p>En genvejstast er en tast, der lader dig foretage en handling ved hjælp af tastaturet, frem for at bruge musen til at vælge en kommando fra en menu eller et dialogvindue. Hver genvejstast markeres ved et understreget tegn i en menu eller ved et dialogvalgmulighed.</p>
	<p>
          Some <app>Zenity</app> dialogs support the use of access keys. To specify the character to use as the access key, place an underscore before that character in the text of the dialog. The following example shows how to specify the letter 'C' as the access key:
	</p>
	<screen><input>"_Choose a name".</input></screen>
    </section>

    <section id="zenity-usage-exitcodes">
      <title>Afslutningskoder</title>
    <p>
        Zenity returns the following exit codes:
    </p>

    <table frame="all" rules="all">
        <thead>
          <tr valign="top">
            <td colname="COLSPEC0">
              <p>Afslutningskode</p></td>
            <td colname="COLSPEC1">
              <p>Beskrivelse</p></td>
          </tr>
        </thead>
        <tbody>
          <tr valign="top">
            <td>
              <p><var>0</var></p>
            </td>
            <td>
              <p>The user has pressed either <gui style="button">OK</gui> or <gui style="button">Close</gui>.</p>
            </td>
          </tr>
          <tr valign="top">
            <td>
              <p><var>1</var></p>
            </td>
            <td>
              <p>The user has either pressed <gui style="button">Cancel</gui>, or used the window functions to close the dialog.</p>
            </td>
          </tr>
          <tr valign="top">
            <td>
              <p><var>-1</var></p>
            </td>
            <td>
              <p>Der opstod en uventet fejl.</p>
            </td>
          </tr>
          <tr valign="top">
            <td>
              <p><var>5</var></p>
            </td>
            <td>
              <p>Dialogvinduet er blevet lukket, fordi tiden er løbet ud.</p>
            </td>
          </tr>
        </tbody>
    </table>

    </section>


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

  <section id="zenity-usage-general-options">
    <title>Generelle tilvalg</title>

    <p>
	All Zenity dialogs support the following general options:
    </p>

    <terms>

      <item>
        <title><cmd>--title</cmd>=<var>title</var></title>
	<p>Angiver titel på et dialogvindue.</p>
      </item>

      <item>
        <title><cmd>--window-icon</cmd>=<var>icon_path</var></title>
	<p>Angiver det ikon, der skal vises i dialogvinduets ramme. Der er fire standardikoner, der kan bruges ved at angive følgende nøgleord: "info", "warning", "question" eller "error".</p>
      </item>

      <item>
        <title><cmd>--width</cmd>=<var>width</var></title>
	<p>Angiver dialogvinduets bredde.</p>
      </item>

      <item>
        <title><cmd>--height</cmd>=<var>height</var></title>
	<p>Angiver dialogvinduets højde.</p>
      </item>

      <item>
        <title><cmd>--timeout</cmd>=<var>timeout</var></title>
	<p>Angiver tidsudløbet i sekunder, hvorefter dialogvinduet lukkes.</p>
      </item>

    </terms>

  </section>

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

  <section id="zenity-help-options">
    <title>Hjælpetilvalg</title>

    <p>
	Zenity provides the following help options:
    </p>

    <terms>

      <item>
        <title><cmd>--help</cmd></title>
	<p>Viser en kort hjælpetekst.</p>
      </item>

      <item>
        <title><cmd>--help-all</cmd></title>
	<p>Viser den fulde hjælpetekst for alle dialogvinduer.</p>
      </item>
 
      <item>
        <title><cmd>--help-general</cmd></title>
	<p>Viser hjælpetekst til de generelle dialogtilvalg.</p>
      </item>
 
      <item>
        <title><cmd>--help-calendar</cmd></title>
	<p>Viser hjælpetekst for kalenderdialogvinduets tilvalg.</p>
      </item>
 
      <item>
        <title><cmd>--help-entry</cmd></title>
	<p>Viser hjælpetekst for tilvalg til tekstindtastningsfelter.</p>
      </item>
 
      <item>
        <title><cmd>--help-error</cmd></title>
	<p>Viser hjælpetekst for tilvalg til dialogvinduer med fejlmeddelelser.</p>
      </item>
 
      <item>
        <title><cmd>--help-info</cmd></title>
	<p>Viser hjælpetekst for tilvalg til dialogvinduer med informationsmeddelelser.</p>
      </item>
 
      <item>
        <title><cmd>--help-file-selection</cmd></title>
	<p>Viser hjælpetekst til filvælgerdialogvinduer.</p>
      </item>
 
      <item>
        <title><cmd>--help-list</cmd></title>
	<p>Viser hjælpetekst til listedialogvinduer.</p>
      </item>
 
      <item>
        <title><cmd>--help-notification</cmd></title>
	<p>Viser hjælpetekst til påmindelsesikoner.</p>
      </item>
 
      <item>
        <title><cmd>--help-progress</cmd></title>
	<p>Viser hjælpetekst til statusbjælkedialogvinduer.</p>
      </item>
 
      <item>
        <title><cmd>--help-question</cmd></title>
	<p>Viser hjælpetekst til spørgsmålsdialogvinduer.</p>
      </item>
 
      <item>
        <title><cmd>--help-warning</cmd></title>
	<p>Viser hjælpetekst til advarselsdialogvinduer.</p>
      </item>
 
      <item>
	<title><cmd>--help-text-info</cmd></title>
	<p>Viser hjælpetekst til informationsdialogvinduer.</p>
      </item>
 
      <item>
        <title><cmd>--help-misc</cmd></title>
	<p>Viser hjælpetekst til diverse tilvalg.</p>
      </item>
 
      <item>
        <title><cmd>--help-gtk</cmd></title>
	<p>Viser hjælp til GTK+-tilvalg.</p>
      </item>
 
    </terms>

  </section>

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

  <section id="zenity-miscellaneous-options">
    <title>Diverse tilvalg</title>

    <p>
	Zenity also provides the following miscellaneous options:
    </p>

    <terms>

      <item>
        <title><cmd>--about</cmd></title>
	<p>Displays the <gui>About Zenity</gui> dialog, which contains Zenity version information, copyright information, and developer information.</p>
      </item>

      <item>
        <title><cmd>--version</cmd></title>
	<p>Displays the version number of Zenity.</p>
      </item>

    </terms>

  </section>

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

  <section id="zenity-gtk-options">
    <title>GTK+-tilvalg</title>

    <p>
	Zenity supports the standard GTK+ options. For more information about the GTK+ options, execute the <cmd>zenity --help-gtk</cmd> command.
    </p>

  </section>

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

  <section id="zenity-environment-variables">
    <title>Miljøvariable</title>

    <p>
      Normally, Zenity detects the terminal window from which it was launched
      and keeps itself above that window.  This behavior can be disabled by
      unsetting the <var>WINDOWID</var> environment variable.
    </p>

  </section>
</page>
