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

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.

Цей підручник є частиною збірки документації з GNOME, що постачається на умовах ліцензії GFDL. Якщо ви бажаєте розповсюджувати цю довідку окремо від збірки, можете це зробити додавши до довідки копію ліцензії, як описано у пункті 6 ліцензії.

Більшість назв, що використовуються компаніями для розповсюдження їх продуктів та послуг є торговими марками. Якщо такі назви зустрічаються у документації з GNOME та учасникам проекту документування GNOME відомо, що вони є торговими марками, тоді ці назви пишуться великими літерами або починаються з великої літери.

ДОКУМЕНТ ТА ЗМІНЕНІ ВЕРСІЇ ДОКУМЕНТУ НАДАЮТЬСЯ КОРИСТУВАЧУ ЗА УМОВАМИ ЛІЦЕНЗІЇ GNU FREE DOCUMENTATION LICENSE З ПОДАЛЬШИМ РОЗУМІННЯМ ПРО ТЕ, ЩО:

ДОКУМЕНТ НАДАЄТЬСЯ "ЯК Є", БЕЗ БУДЬ-ЯКИХ ГАРАНТІЇ, ЯВНИХ ЧИ НЕЯВНИХ, ВКЛЮЧАЮЧИ, АЛЕ НЕ ОБМЕЖУЮЧИСЬ, ГАРАНТІЙ, ЩО ЦЕЙ ДОКУМЕНТ ЧИ ЗМІНЕНА ВЕРСІЯ ДОКУМЕНТА ВІЛЬНІ ВІД ДЕФЕКТІВ, ПРИДАТНІ ДО ПРОДАЖУ, ВІДПОВІДАЮТЬ ПЕВНІЙ МЕТІ АБО НЕ ПОРУШУЮТЬ ЧИЇСЬ ПРАВА. ВЕСЬ РИЗИК ЗА ЯКІСТЬ, ТОЧНІСТЬ, ТА ЧИННІСТЬ ЦЬОГО ДОКУМЕНТУ АБО ЙОГО ЗМІНЕНИХ ВЕРСІЙ ЛЕЖИТЬ НА ВАС. ЯКЩО БУДЬ-ЯКИЙ ДОКУМЕНТ ЧИ ЗМІНЕНА ВЕРСІЯ БУДУТЬ ВИЗНАНІ ДЕФЕКТНИМИ У БУДЬ-ЯКОМУ ВІДНОШЕННІ, ВИ (НЕ ПОЧАТКОВИЙ УКЛАДАЧ, АВТОР АБО БУДЬ-ЯКИЙ СПІВАВТОР) БЕРЕТЕ НА СЕБЕ ВИТРАТИ ЗА БУДЬ-ЯКЕ НЕОБХІДНЕ ОБСЛУГОВУВАННЯ, РЕМОНТ ЧИ ВИПРАВЛЕННЯ. ЦЯ ВІДМОВА ВІД ГАРАНТІЙ СКЛАДАЄ ВАЖЛИВУ ЧАСТИНУ ЦІЄЇ ЛІЦЕНЗІЇ. НЕ ДОПУСКАЄТЬСЯ ВИКОРИСТАННЯ ЦЬОГО ДОКУМЕНТУ АБО ЙОГО ЗМІНЕНОЇ ВЕРСІЇ БЕЗ ПРИЙНЯТТЯ ЦІЄЇ ВІДМОВИ; ТА

НІ ЗА ЯКИХ ОБСТАВИН ТА ЗА БУДЬ-ЯКОГО ЗАКОНОДАВСТВА, ЧИ ТО ГРОМАДЯНСЬКОЇ ВІДПОВІДАЛЬНОСТІ (ВКЛЮЧАЮЧИ ХАЛАТНІСТЬ), ДОГОВОРУ, ЧИ ЧОГОСЬ ІНШОГО, АВТОР, ПОЧАТКОВИЙ УКЛАДАЧ, БУДЬ-ЯКИЙ СПІВАВТОР, АБО ДИСТРИБ'ЮТОР ДОКУМЕНТУ ЧИ ЗМІНЕНОЇ ВЕРСІЇ ДОКУМЕНТУ, АБО БУДЬ-ЯКИЙ ПОСТАЧАЛЬНИК БУДЬ-ЯКОЇ З ЦИХ СТОРІН, НЕ НЕСЕ ВІДПОВІДАЛЬНІСТЬ ПЕРЕД БУДЬ-ЯКОЮ ОСОБОЮ ЗА БУДЬ-ЯКІ ПРЯМІ, НЕПРЯМІ, ОСОБЛИВІ, ВИПАДКОВІ, АБО ІСТОТНІ ЗБИТКИ БУДЬ-ЯКОГО ХАРАКТЕРУ ВКЛЮЧАЮЧИ, АЛЕ НЕ ОБМЕЖУЮЧИСЬ, ЗБИТКАМИ ВІД ВТРАТИ ПРЕСТИЖУ, ЗУПИНКИ РОБОТИ, ЗБОЇВ АБО НЕСПРАВНОСТЕЙ КОМП'ЮТЕРА, АБО БУДЬ-ЯКІ ІНШІ ЗБИТКИ АБО ВТРАТИ, ЩО ВИНИКЛИ БЕЗВІДНОСНО АБО ВНАСЛІДОК ВИКОРИСТАННЯ ЦЬОГО ДОКУМЕНТУ ТА ЗМІНЕНИХ ВЕРСІЙ ЦЬОГО ДОКУМЕНТУ, НАВІТЬ ЯКЩО ЦІ СТОРОНИ, МОЖЛИВО, БУЛИ ПРОІНФОРМОВАНІ ПРО МОЖЛИВІСТЬ ТАКИХ ЗБИТКІВ.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## --title=заголовок

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

## --width=ширина

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

## --height=висота

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

## --timeout=час_очікування

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

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

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

## --help

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

## --help-all

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

## --help-general

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

## --help-calendar

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

## --help-entry

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

## --help-error

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

## --help-info

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

## --help-file-selection

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

## --help-list

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

## --help-notification

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

## --help-progress

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

## --help-question

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

## --help-warning

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

## --help-text-info

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

## --help-misc

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

## --help-gtk

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

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

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

## --about

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

## --version

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

# Параметри GTK+

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

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

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