<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="usage" lang="pl">
<info>
  <link type="guide" xref="index"/>
  <desc>Można używać <app>Zenity</app> do tworzenia prostych okien dialogowych obsługiwanych przez użytkownika.</desc>
  <license xmlns="http://projectmallard.org/1.0/" href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">

  <p>This work is licensed under a
  <link href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">GNU Free
  Documentation License Version 1.1</link> or any later version.</p>

	<p>
	  Permission is granted to copy, distribute and/or modify this
	  document under the terms of the GNU Free Documentation
	  License (GFDL), Version 1.1 or any later version published
	  by the Free Software Foundation with no Invariant Sections,
	  no Front-Cover Texts, and no Back-Cover Texts.  You can find
	  a copy of the GFDL at this
	  <link href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">link</link>.
         </p>
         <p>Ten podręcznik jest częścią kolekcji podręczników użytkownika GNOME rozprowadzanych na zasadach GFDL. Jeśli chcesz rozpowszechniać ten podręcznik w odłączeniu od kolekcji, możesz to zrobić dodając kopię licencji do podręcznika, jak wyjaśniono to w sekcji 6. licencji.</p>

	<p>Nazwy używane przez firmy, by wyróżniać swoje produkty i usługi są zazwyczaj zarejestrowanymi znakami towarowymi. Jeśli występują one w dokumentacji GNOME, w przypadku gdy są znane przez członków Projektu Dokumentacji GNOME, są one napisane wielkimi literami lub zaczynają się od wielkiej litery.</p>

	<p>DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE WITH THE FURTHER UNDERSTANDING THAT:</p>
	<list>
		<item>
		  <p>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</p>
		</item>
		<item>
		  <p>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.</p>
		</item>
	  </list>
</license>
<credit type="translator copyright"><name>Piotr Drąg</name><email>piotrdrag@gmail.com</email><years>2017-2019</years></credit><credit type="translator copyright"><name>Aviary.pl</name><email>community-poland@mozilla.org</email><years>2017-2019</years></credit></info>
<title>Użycie</title>
    <p>Podczas pisania skryptów można używać programu <app>Zenity</app> do tworzenia prostych okien dialogowych obsługiwanych przez użytkownika:</p>
    <list>
      <item>
        <p>Można utworzyć okno, aby uzyskać informacje od użytkownika. Na przykład, można poprosić użytkownika o wybranie daty z kalendarza, albo o wybranie pliku.</p>
      </item>
      <item>
        <p>Można utworzyć okno, aby przekazać użytkownikowi informacje. Na przykład, można użyć okno z postępem, aby informować o obecnym stanie działania, albo użyć okna z ostrzeżeniem, aby powiadomić użytkownika o niebezpieczeństwie.</p>
      </item>
    </list>
    <p>Po zamknięciu okna przez użytkownika <app>Zenity</app> wyświetla tekst utworzony przez okno w standardowym wyjściu.</p>

    <note>
      <p>Podczas pisania poleceń <app>Zenity</app> należy się upewnić, że każdy parametr jest w cudzysłowach.</p>
      <p>Prawidłowe polecenie:</p>
      <screen>zenity --calendar --title="Plan wakacji"</screen>
      <p>Nieprawidłowe polecenie:</p>
      <screen>zenity --calendar --title=Plan wakacji</screen>
      <p>Pominięcie cudzysłowów spowoduje nieoczekiwane wyniki.</p>
    </note>

    <section id="zenity-usage-mnemonics">
      <title>Klawisze dostępu</title>
	<p>Klawisz dostępu umożliwia wykonanie działania za pomocą klawiatury, zamiast używać myszy do wyboru polecenia z menu lub okna dialogowego. Klawisze dostępu można rozpoznać po podkreślonej literze w menu lub opcji okna.</p>
	<p>Część okien <app>Zenity</app> obsługuje klawisze dostępu. Aby określić znak używany jako klawisz dostępu, umieść znak podkreślenia przed tym znakiem w tekście okna. Ten przykład pokazuje, jak określić literę „W” jako klawisz dostępu:</p>
	<screen><input>"_Wybierz nazwę"</input></screen>
    </section>

    <section id="zenity-usage-exitcodes">
      <title>Kody wyjściowe</title>
    <p>Zenity zwraca te kody wyjściowe:</p>

    <table frame="all" rules="all">
        <thead>
          <tr>
            <td>
              <p>Kod wyjściowy</p></td>
            <td>
              <p>Opis</p></td>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>
              <p><var>0</var></p>
            </td>
            <td>
              <p>Użytkownik kliknął przycisk <gui style="button">OK</gui> lub <gui style="button">Zamknij</gui>.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>1</var></p>
            </td>
            <td>
              <p>Użytkownik kliknął przycisk <gui style="button">Anuluj</gui> lub „×” okna.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>-1</var></p>
            </td>
            <td>
              <p>Wystąpił nieoczekiwany błąd.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>5</var></p>
            </td>
            <td>
              <p>Okno zostało zamknięte, ponieważ przekroczono czas oczekiwania.</p>
            </td>
          </tr>
        </tbody>
    </table>

    </section>


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

  <section id="zenity-usage-general-options">
    <title>Ogólne opcje</title>

    <p>Wszystkie okna Zenity obsługują te ogólne opcje:</p>

    <terms>

      <item>
        <title><cmd>--title</cmd>=<var>tytuł</var></title>
	<p>Określa tytuł okna.</p>
      </item>

      <item>
        <title><cmd>--window-icon</cmd>=<var>ścieżka-do-ikony</var></title>
	<p>Określa ikonę wyświetlaną w ramce okna. Dostępne są także cztery standardowe ikony, które można określić słowami kluczowymi „info” (informacja), „warning” (ostrzeżenie), „question” (pytanie) i „error” (błąd).</p>
      </item>

      <item>
        <title><cmd>--width</cmd>=<var>szerokość</var></title>
	<p>Określa szerokość okna.</p>
      </item>

      <item>
        <title><cmd>--height</cmd>=<var>wysokość</var></title>
	<p>Określa wysokość okna.</p>
      </item>

      <item>
        <title><cmd>--timeout</cmd>=<var>czas-oczekiwania</var></title>
	<p>Określa czas oczekiwania w sekundach, po jakich okno zostanie zamknięte.</p>
      </item>

    </terms>

  </section>

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

  <section id="zenity-help-options">
    <title>Opcje pomocy</title>

    <p>Zenity dostarcza te opcje pomocy:</p>

    <terms>

      <item>
        <title><cmd>--help</cmd></title>
	<p>Wyświetla skrócony tekst pomocy.</p>
      </item>

      <item>
        <title><cmd>--help-all</cmd></title>
	<p>Wyświetla pełny tekst pomocy dla wszystkich okien.</p>
      </item>
 
      <item>
        <title><cmd>--help-general</cmd></title>
	<p>Wyświetla tekst pomocy dla ogólnych opcji okna.</p>
      </item>
 
      <item>
        <title><cmd>--help-calendar</cmd></title>
	<p>Wyświetla tekst pomocy dla opcji okna kalendarza.</p>
      </item>
 
      <item>
        <title><cmd>--help-entry</cmd></title>
	<p>Wyświetla tekst pomocy dla opcji okna wpisywania tekstu.</p>
      </item>
 
      <item>
        <title><cmd>--help-error</cmd></title>
	<p>Wyświetla tekst pomocy dla opcji okna z błędem.</p>
      </item>
 
      <item>
        <title><cmd>--help-info</cmd></title>
	<p>Wyświetla tekst pomocy dla opcji okna z informacją.</p>
      </item>
 
      <item>
        <title><cmd>--help-file-selection</cmd></title>
	<p>Wyświetla tekst pomocy dla opcji okna wyboru pliku.</p>
      </item>
 
      <item>
        <title><cmd>--help-list</cmd></title>
	<p>Wyświetla tekst pomocy dla opcji okna z listą.</p>
      </item>
 
      <item>
        <title><cmd>--help-notification</cmd></title>
	<p>Wyświetla tekst pomocy dla opcji ikony powiadamiania.</p>
      </item>
 
      <item>
        <title><cmd>--help-progress</cmd></title>
	<p>Wyświetla tekst pomocy dla opcji okna z postępem.</p>
      </item>
 
      <item>
        <title><cmd>--help-question</cmd></title>
	<p>Wyświetla tekst pomocy dla opcji okna z pytaniem.</p>
      </item>
 
      <item>
        <title><cmd>--help-warning</cmd></title>
	<p>Wyświetla tekst pomocy dla opcji okna z ostrzeżeniem.</p>
      </item>
 
      <item>
	<title><cmd>--help-text-info</cmd></title>
	<p>Wyświetla pomoc dla opcji okna z informacją tekstową.</p>
      </item>
 
      <item>
        <title><cmd>--help-misc</cmd></title>
	<p>Wyświetla pomoc dla różnych opcji.</p>
      </item>
 
      <item>
        <title><cmd>--help-gtk</cmd></title>
	<p>Wyświetla pomoc dla opcji biblioteki GTK.</p>
      </item>
 
    </terms>

  </section>

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

  <section id="zenity-miscellaneous-options">
    <title>Różne opcje</title>

    <p>Zenity dostarcza także te różne opcje:</p>

    <terms>

      <item>
        <title><cmd>--about</cmd></title>
	<p>Wyświetla okno <gui>O programie Zenity</gui>, zawierające wersję oraz informacje o prawach autorskich i programistach.</p>
      </item>

      <item>
        <title><cmd>--version</cmd></title>
	<p>Wyświetla wersję Zenity.</p>
      </item>

    </terms>

  </section>

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

  <section id="zenity-gtk-options">
    <title>Opcje biblioteki GTK</title>

    <p>Zenity obsługuje standardowe opcje biblioteki GTK. Wykonanie polecenia <cmd>zenity --help-gtk</cmd> wyświetli więcej informacji.</p>

  </section>

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

  <section id="zenity-environment-variables">
    <title>Zmienne środowiskowe</title>

    <p>Zwykle program Zenity wykrywa okno terminala, z którego został uruchomiony i wyświetla swoje okna nad tym oknem. Można to wyłączyć usuwając ustawienie zmiennej środowiskowej <var>WINDOWID</var>.</p>

  </section>
</page>
