Można używać Zenity do tworzenia prostych okien dialogowych obsługiwanych przez użytkownika.
Piotr Drąg
piotrdrag@gmail.com 2017-2019
Aviary.pl
community-poland@mozilla.org 2017-2019

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

## --window-icon=ścieżka-do-ikony

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

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