Использование

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

  • Вы можете создать диалоговое окно, чтобы получить информацию от пользователя. Например, вы можете попросить пользователя выбрать дату из календаря или выбрать файл из окна выбора файла.
  • Вы можете создать диалоговое окно, чтобы предоставить информацию пользователю. Например, вы можете использовать окно с ходом выполнения, чтобы указать текущее состояние операции или использовать окно предупреждения, чтобы оповестить пользователя.

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

Когда вы пишите команды Zenity, убедитесь, что вы помещаете каждый аргумент в кавычки.

Например, используйте:

zenity --calendar --title="Планировщик праздников"
Не пишите:
zenity --calendar --title=Планировщик праздников

Если не использовать кавычки, то можно получить неожиданные результаты.

2.1 Клавиши доступа

Клавиша доступа это клавиша, которая позволяет вам выполнять действие с клавиатуры, нежели используя мышь, для выбора команды из меню или диалогового окна. Каждая клавиша доступа назначается с помощью подчёркнутой буквы в параметре, задающем текст меню или диалогового окна.

Некоторые окна Zenity поддерживают использование клавиш доступа. Чтобы указать символ, который нужно использовать для клавиши доступа, поместите знак подчёркивания перед тем символом в тексте диалогового окна. Следующий пример показывает, как установить букву «В» для клавиши доступа:

"_Выберите имя".

2.2 Коды Выхода

Zenity возвращает следующие коды выхода:

Код выхода Описание
0 Пользователь нажал либо OK, либо Закрыть.
1 Пользователь нажал либо Отмена, либо использовал функции окна, чтобы закрыть диалоговое окно.
-1 Произошла неожиданная ошибка.
5 Окно диалога закрыто из-за завершения времени ожидания.

2.3 Общие параметры

Все диалоговые окна Zenity поддерживают следующие общие параметры:

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

Указывает заголовок диалогового окна.

--window-icon=путь_к_значку

Указывает значок, который изображается в рамке диалогового окна. Существуют 4 запасных значка, доступных по следующим ключевым словам: info, warning, question и error.

--width=ширина

Указывает ширину диалогового окна.

--height=высота

Указывает высоту диалогового окна.

--timeout=время_ожидания

Указывает время ожидания в секундах, по истечении которого диалоговое окно закрывается.

2.4 Параметры вызова справки

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

2.5 Разнообразные параметры

Zenity также может запускаться со следующими дополнительными параметрами:

--about

Изображает диалоговое окно О программе Zenity, которое содержит информацию о версии Zenity, информацию об авторских правах и информацию о разработчике.

--version

Изображает номер версии Zenity.

2.6 Параметры GTK+

Zenity поддерживает стандартные параметры программ GTK+. Для получения дополнительной информации о параметрах GTK+, выполните команду zenity -?.

2.7 Переменные окружения

Обычно, Zenity определяет окно терминала из которого она была запущена и выводит диалоговые окна поверх этого окна. Это можно отключить удалив переменную окружения WINDOWID.