<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="usage" xml:lang="ru">
<info>
  <link type="guide" xref="index"/>
  <desc>Вы можете использовать <app>Zenity</app> для создания простых графических диалоговых окон, которые взаимодействуют с пользователем.</desc>
  <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Deshko Yury</mal:name>
      <mal:email>deshko@tut.by</mal:email>
      <mal:years>2007</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Yuri Kozlov</mal:name>
      <mal:email>yuray@komyakino.ru</mal:email>
      <mal:years>2011</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Ser82-png</mal:name>
      <mal:email>asvmail.as@gmail.com</mal:email>
      <mal:years>2023</mal:years>
    </mal:credit>
  </info>
<title>Использование</title>
    <p>Когда вы пишите сценарии, вы можете использовать <app>Zenity</app> для создания простых графических диалоговых окон, которые взаимодействуют с пользователем, как в следующих случаях:</p>
    <list>
      <item>
        <p>Вы можете создать диалоговое окно, чтобы получить информацию от пользователя. Например, вы можете попросить пользователя выбрать дату из календаря или выбрать файл из окна выбора файла.</p>
      </item>
      <item>
        <p>Вы можете создать диалоговое окно, чтобы предоставить информацию пользователю. Например, вы можете использовать окно с ходом выполнения, чтобы указать текущее состояние операции или использовать окно предупреждения, чтобы оповестить пользователя.</p>
      </item>
    </list>
    <p>Когда пользователь закрывает диалоговое окно, <app>Zenity</app> печатает текст, создаваемый окном, в стандартный поток вывода.</p>

    <note>
      <p>Когда вы пишите команды <app>Zenity</app>, убедитесь, что вы помещаете каждый аргумент в кавычки.</p>
      <p>Пример использования:</p>
      <screen>zenity --calendar --title="Планирование праздников"</screen>
      <p>Не используйте:</p>
      <screen>zenity --calendar --title=Планирование праздников</screen>
      <p>Если не использовать кавычки, то можно получить неожиданные результаты.</p>
    </note>

    <section id="zenity-usage-mnemonics">
      <title>Клавиши доступа</title>
	<p>Клавиша доступа это клавиша, которая позволяет вам выполнять действие с клавиатуры, нежели используя мышь, для выбора команды из меню или диалогового окна. Каждая клавиша доступа назначается с помощью подчёркнутой буквы в параметре, задающем текст меню или диалогового окна.</p>
	<p>Некоторые окна <app>Zenity</app> поддерживают использование клавиш доступа. Чтобы указать символ, который нужно использовать для клавиши доступа, поместите знак подчёркивания перед тем символом в тексте диалогового окна. Следующий пример показывает, как установить букву «В» для клавиши доступа:</p>
	<screen><input>"_Выберите имя".</input></screen>
    </section>

    <section id="zenity-usage-exitcodes">
      <title>Коды завершения</title>
    <p>Zenity возвращает следующие коды завершения:</p>

    <table frame="all" rules="all">
        <thead>
          <tr>
            <td>
              <p>Код завершения</p></td>
            <td>
              <p>Описание</p></td>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>
              <p><var>0</var></p>
            </td>
            <td>
              <p>Пользователь нажал кнопку <gui style="button">OK</gui> или <gui style="button">Закрыть</gui>.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>1</var></p>
            </td>
            <td>
              <p>Пользователь нажал кнопку <gui style="button">Отменить</gui>, или закрыл диалоговое окно, используя кнопку окна.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>-1</var></p>
            </td>
            <td>
              <p>Возникла непредвиденная ошибка.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>5</var></p>
            </td>
            <td>
              <p>Диалоговое окно закрыто из-за истёкшего времени ожидания.</p>
            </td>
          </tr>
        </tbody>
    </table>

    </section>


  <!-- ==== General Options ====== -->

  <section id="zenity-usage-general-options">
    <title>Общие параметры</title>

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

    <terms>

      <item>
        <title><cmd>--title</cmd>=<var>заголовок</var></title>
	<p>Указывает заголовок диалогового окна.</p>
      </item>

      <item>
        <title><cmd>--width</cmd>=<var>ширина</var></title>
	<p>Указывает ширину диалогового окна.</p>
      </item>

      <item>
        <title><cmd>--height</cmd>=<var>высота</var></title>
	<p>Указывает высоту диалогового окна.</p>
      </item>

      <item>
        <title><cmd>--timeout</cmd>=<var>время_ожидания</var></title>
	<p>Указывает время ожидания в секундах, по истечении которого диалоговое окно закрывается.</p>
      </item>

    </terms>

  </section>

<!-- ==== Miscellaneous Options ====== -->

  <section id="zenity-help-options">
    <title>Параметры вызова справки</title>

    <p>Zenity предоставляет следующие параметры справки:</p>

    <terms>

      <item>
        <title><cmd>--help</cmd></title>
	<p>Показывает сокращённый текст справки.</p>
      </item>

      <item>
        <title><cmd>--help-all</cmd></title>
	<p>Показывает полный текст справки для всех диалоговых окон.</p>
      </item>
 
      <item>
        <title><cmd>--help-general</cmd></title>
	<p>Показывает текст справки по общим параметрам диалоговых окон.</p>
      </item>
 
      <item>
        <title><cmd>--help-calendar</cmd></title>
	<p>Показывает текст справки по параметрам диалогового окна календаря.</p>
      </item>
 
      <item>
        <title><cmd>--help-entry</cmd></title>
	<p>Показывает текст справки по параметрам диалогового окна ввода текста.</p>
      </item>
 
      <item>
        <title><cmd>--help-error</cmd></title>
	<p>Показывает текст справки по параметрам диалогового окна сообщения об ошибке.</p>
      </item>
 
      <item>
        <title><cmd>--help-info</cmd></title>
	<p>Показывает текст справки по параметрам информационного диалогового окна.</p>
      </item>
 
      <item>
        <title><cmd>--help-file-selection</cmd></title>
	<p>Показывает текст справки по параметрам диалогового окна выбора файла.</p>
      </item>
 
      <item>
        <title><cmd>--help-list</cmd></title>
	<p>Показывает текст справки по параметрам диалогового окна списка.</p>
      </item>
 
      <item>
        <title><cmd>--help-notification</cmd></title>
	<p>Показывает текст справки по параметрам значка уведомлений.</p>
      </item>
 
      <item>
        <title><cmd>--help-progress</cmd></title>
	<p>Показывает текст справки по параметрам диалогового окна хода выполнения.</p>
      </item>
 
      <item>
        <title><cmd>--help-question</cmd></title>
	<p>Показывает текст справки по параметрам диалогового окна вопроса.</p>
      </item>
 
      <item>
        <title><cmd>--help-warning</cmd></title>
	<p>Показывает текст справки по параметрам диалогового окна предупреждения.</p>
      </item>
 
      <item>
	<title><cmd>--help-text-info</cmd></title>
	<p>Показывает текст справки по параметрам диалогового окна текстовой информации.</p>
      </item>
 
      <item>
        <title><cmd>--help-misc</cmd></title>
	<p>Показывает справки по разнообразным параметрам.</p>
      </item>
 
      <item>
        <title><cmd>--help-gtk</cmd></title>
	<p>Показывает справку по параметрам GTK+.</p>
      </item>
 
    </terms>

  </section>

<!-- ==== Miscellaneous Options ====== -->

  <section id="zenity-miscellaneous-options">
    <title>Прочие параметры</title>

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

    <terms>

      <item>
        <title><cmd>--about</cmd></title>
	<p>Изображает диалоговое окно <gui>О приложении Zenity</gui>, которое содержит информацию о версии Zenity, информацию об авторских правах и информацию о разработчике.</p>
      </item>

      <item>
        <title><cmd>--version</cmd></title>
	<p>Отображает номер версии Zenity.</p>
      </item>

    </terms>

  </section>

<!-- ==== GTK+ Options ====== -->

  <section id="zenity-gtk-options">
    <title>Параметры GTK+</title>

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

  </section>

<!-- ==== Environment variables ==== -->

  <section id="zenity-environment-variables">
    <title>Переменные окружения</title>

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

  </section>
</page>
