Można używać Zenity do tworzenia prostych okien dialogowych obsługiwanych przez użytkownika.

This work is licensed under a GNU Free Documentation License Version 1.1 or any later version.

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.

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.

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.

DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE WITH THE FURTHER UNDERSTANDING THAT:

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

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.

Piotr Drąg
piotrdrag@gmail.com 2017-2023
Aviary.pl
community-poland@mozilla.org 2017-2023

# Użycie

Podczas pisania skryptów można używać programu Zenity do tworzenia prostych okien dialogowych obsługiwanych przez użytkownika:

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.

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.

Po zamknięciu okna przez użytkownika Zenity wyświetla tekst utworzony przez okno w standardowym wyjściu.

Podczas pisania poleceń Zenity należy się upewnić, że każdy parametr jest w cudzysłowach.

Prawidłowe polecenie:

    zenity --calendar --title="Plan wakacji"

Nieprawidłowe polecenie:

    zenity --calendar --title=Plan wakacji

Pominięcie cudzysłowów spowoduje nieoczekiwane wyniki.

# Klawisze dostępu

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.

Część okien Zenity 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:

    "_Wybierz nazwę"

# Kody wyjściowe

Zenity zwraca te kody wyjściowe:

Kod wyjściowy | Opis
--- | ---
0 | Użytkownik kliknął przycisk OK lub Zamknij.
1 | Użytkownik kliknął przycisk Anuluj lub „×” okna.
-1 | Wystąpił nieoczekiwany błąd.
5 | Okno zostało zamknięte, ponieważ przekroczono czas oczekiwania.

# Ogólne opcje

Wszystkie okna Zenity obsługują te ogólne opcje:

## --title=tytuł

Określa tytuł okna.

## --width=szerokość

Określa szerokość okna.

## --height=wysokość

Określa wysokość okna.

## --timeout=czas-oczekiwania

Określa czas oczekiwania w sekundach, po jakich okno zostanie zamknięte.

# Opcje pomocy

Zenity dostarcza te opcje pomocy:

## --help

Wyświetla skrócony tekst pomocy.

## --help-all

Wyświetla pełny tekst pomocy dla wszystkich okien.

## --help-general

Wyświetla tekst pomocy dla ogólnych opcji okna.

## --help-calendar

Wyświetla tekst pomocy dla opcji okna kalendarza.

## --help-entry

Wyświetla tekst pomocy dla opcji okna wpisywania tekstu.

## --help-error

Wyświetla tekst pomocy dla opcji okna z błędem.

## --help-info

Wyświetla tekst pomocy dla opcji okna z informacją.

## --help-file-selection

Wyświetla tekst pomocy dla opcji okna wyboru pliku.

## --help-list

Wyświetla tekst pomocy dla opcji okna z listą.

## --help-notification

Wyświetla tekst pomocy dla opcji ikony powiadamiania.

## --help-progress

Wyświetla tekst pomocy dla opcji okna z postępem.

## --help-question

Wyświetla tekst pomocy dla opcji okna z pytaniem.

## --help-warning

Wyświetla tekst pomocy dla opcji okna z ostrzeżeniem.

## --help-text-info

Wyświetla pomoc dla opcji okna z informacją tekstową.

## --help-misc

Wyświetla pomoc dla różnych opcji.

## --help-gtk

Wyświetla pomoc dla opcji biblioteki GTK.

# Różne opcje

Zenity dostarcza także te różne opcje:

## --about

Wyświetla okno O programie Zenity, zawierające wersję oraz informacje o prawach autorskich i programistach.

## --version

Wyświetla wersję Zenity.

# Opcje biblioteki GTK

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

# Zmienne środowiskowe

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 WINDOWID.