Використання

Ви можете скористатися Zenity для створення простих діалогових вікон графічної взаємодії з користувачем. Використання

Коли ви пишете сценарій, можете використовувати Zenity для створення простих діалогових вікон графічної взаємодії з користувачем, а саме:

Можна створити діалогове вікно для отримання інформації від користувача. Наприклад, можна спитати у користувача дату у діалоговому вікні календаря, або вибрати файл у вікні вибору файлів.

Можна створити діалогове вікно для виводу інформації користувачу. Наприклад, можна створити діалогове вікно з індикатором поступу поточної операції, або вивести попереджувальне повідомлення.

Коли користувач закриває вікно, Zenity виводить створений діалоговим вікном текст у стандартний потік виводу.

Коли ви пишете команди Zenity, перевірте, що ви ставите лапки навколо кожного аргументу.

Наприклад, використовуйте:

zenity --calendar --title="Планувальник вихідних"

Не використовуйте:

zenity --calendar --title=Планувальник вихідних

Якщо ви пропустите липки можете отримати несподіваний результат.

Комбінації клавіш

Клавіші доступу - клавіші, які дозволяють виконати дію з клавіатури, а не через вибір команд мишею. Кожен символ, що утворює комбінацію виділяється підкресленням у меню чи вікні.

У деяких вікнах Zenity передбачено підтримку клавіатурних скорочень. Щоб вказати, що символ використовується для комбінації клавіш, вставте перед ним символ підкреслення. У наступному прикладі показано, як це зробити для літери «В»:

"_Виберіть ім'я".

Коди завершення

Zenity повертає наступні коди завершення:

Код завершення	Опис
`0`	Користувач натиснув Гаразд або Закрити.
`1`	Користувач або натиснув Скасувати, або закрив вікно, використовуючи кнопку вікна.
`-1`	Несподівана помилка.
`5`	Вікно закрито через вичерпання часу очікування.

Загальні параметри

У всіх вікнах Zenity передбачено підтримку таких загальних параметрів:

<cmd>--title</cmd>=<var>заголовок</var>

Вказує заголовок діалогового вікна.

<cmd>--window-icon</cmd>=<var>шлях_до_піктограми</var>

Вказує значок, який буде показано у рамці діалогового вікна. Є 4 вбудовані значки, які вказуються ключовими словами «info», «warning», «question» та «error».

<cmd>--width</cmd>=<var>ширина</var>

Вказує ширину вікна.

<cmd>--height</cmd>=<var>висота</var>

Вказує висоту вікна.

<cmd>--timeout</cmd>=<var>час_очікування</var>

Вказує час очікування у секундах, після якого діалогове вікно буде закрите.

Параметри довідки

У Zenity передбачено такі параметри довідки:

Показує коротку довідку.

Показує повну довідку з усіх вікон.

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

Показує довідку із загальних параметрів вікон.

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

Показує довідку про параметри вікна календаря.

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

Показує довідку про параметри вікна вводу тексту.

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

Показує довідку про параметри вікна сповіщення про помилку.

Показує довідку про параметри вікна з інформацією.

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

Показує довідку про параметри вікна вибору файлів.

Показує довідку про параметри вікна списку.

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

Показує довідку про параметри значка в області сповіщення.

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

Показує довідку про параметри вікна поступу.

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

Показує довідку про параметри вікна запитання.

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

Показує довідку про параметри вікна попередження.

Показує довідку про параметри вікна інформаційного тексту.

Показує довідку про різні параметри.

Показує довідку про параметри GTK+.

Інші параметри

Крім того, Zenity має наступні інші параметри:

<cmd>--about</cmd>

Показує діалогове вікно Про Zenity, яке містить інформацію про версію Zenity, авторські права та інформацію про розробників.

<cmd>--version</cmd>

Показує номер версії програми Zenity.

Параметри GTK+

У Zenity передбачено підтримку стандартних параметрів GTK+. Докладніше про параметри GTK+, можна дізнатись виконавши zenity --help-gtk.

Змінні оточення

Звичайно, Zenity визначає вікно термінала, з якого її запущено та тримає своє вікно над вікном термінала. Цю поведінку можна вимкнути, знявши змінну оточення WINDOWID.