Można używać Zenity do tworzenia prostych okien dialogowych obsługiwanych przez użytkownika. Piotr Drąg piotrdrag@gmail.com 2017 Aviary.pl community-poland@mozilla.org 2017 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:

<cmd>--title</cmd>=<var>tytuł</var>

Określa tytuł okna.

 <cmd>--window-icon</cmd>=<var>ścieżka-do-ikony</var>

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

 <cmd>--width</cmd>=<var>szerokość</var>

Określa szerokość okna.

 <cmd>--height</cmd>=<var>wysokość</var>

Określa wysokość okna.

 <cmd>--timeout</cmd>=<var>czas-oczekiwania</var>

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

Zenity dostarcza te opcje pomocy:

<cmd>--help</cmd>

Wyświetla skrócony tekst pomocy.

 <cmd>--help-all</cmd>

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

 <cmd>--help-general</cmd>

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

 <cmd>--help-calendar</cmd>

Wyświetla tekst pomocy dla opcji okna kalendarza.

 <cmd>--help-entry</cmd>

Wyświetla tekst pomocy dla opcji okna wpisywania tekstu.

 <cmd>--help-error</cmd>

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

 <cmd>--help-info</cmd>

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

 <cmd>--help-file-selection</cmd>

Wyświetla tekst pomocy dla opcji okna wyboru pliku.

 <cmd>--help-list</cmd>

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

 <cmd>--help-notification</cmd>

Wyświetla tekst pomocy dla opcji ikony powiadamiania.

 <cmd>--help-progress</cmd>

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

 <cmd>--help-question</cmd>

Wyświetla tekst pomocy dla opcji okna z pytaniem.

 <cmd>--help-warning</cmd>

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

 <cmd>--help-text-info</cmd>

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

 <cmd>--help-misc</cmd>

Wyświetla pomoc dla różnych opcji.

 <cmd>--help-gtk</cmd>

Wyświetla pomoc dla opcji biblioteki GTK+.
Różne opcje

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

<cmd>--about</cmd>

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

 <cmd>--version</cmd>

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.