<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="usage" lang="uk">
<info>
  <link type="guide" xref="index"/>
  <desc>Ви можете скористатися <app>Zenity</app> для створення простих діалогових вікон графічної взаємодії з користувачем.</desc>
  <license xmlns="http://projectmallard.org/1.0/" href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">

  <p>This work is licensed under a
  <link href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">GNU Free
  Documentation License Version 1.1</link> or any later version.</p>

	<p>
	  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 href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">link</link>.
         </p>
         <p>Цей підручник є частиною збірки документації з GNOME, що постачається на умовах ліцензії GFDL. Якщо ви бажаєте розповсюджувати цю довідку окремо від збірки, можете це зробити додавши до довідки копію ліцензії, як описано у пункті 6 ліцензії.</p>

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

	<p>ДОКУМЕНТ ТА ЗМІНЕНІ ВЕРСІЇ ДОКУМЕНТУ НАДАЮТЬСЯ КОРИСТУВАЧУ ЗА УМОВАМИ ЛІЦЕНЗІЇ GNU FREE DOCUMENTATION LICENSE З ПОДАЛЬШИМ РОЗУМІННЯМ ПРО ТЕ, ЩО:</p>
	<list>
		<item>
		  <p>ДОКУМЕНТ НАДАЄТЬСЯ "ЯК Є", БЕЗ БУДЬ-ЯКИХ ГАРАНТІЇ, ЯВНИХ ЧИ НЕЯВНИХ, ВКЛЮЧАЮЧИ, АЛЕ НЕ ОБМЕЖУЮЧИСЬ, ГАРАНТІЙ, ЩО ЦЕЙ ДОКУМЕНТ ЧИ ЗМІНЕНА ВЕРСІЯ ДОКУМЕНТА ВІЛЬНІ ВІД ДЕФЕКТІВ, ПРИДАТНІ ДО ПРОДАЖУ, ВІДПОВІДАЮТЬ ПЕВНІЙ МЕТІ АБО НЕ ПОРУШУЮТЬ ЧИЇСЬ ПРАВА. ВЕСЬ РИЗИК ЗА ЯКІСТЬ, ТОЧНІСТЬ, ТА ЧИННІСТЬ ЦЬОГО ДОКУМЕНТУ АБО ЙОГО ЗМІНЕНИХ ВЕРСІЙ ЛЕЖИТЬ НА ВАС.  ЯКЩО БУДЬ-ЯКИЙ ДОКУМЕНТ ЧИ ЗМІНЕНА ВЕРСІЯ БУДУТЬ ВИЗНАНІ ДЕФЕКТНИМИ У БУДЬ-ЯКОМУ ВІДНОШЕННІ, ВИ (НЕ ПОЧАТКОВИЙ УКЛАДАЧ, АВТОР АБО БУДЬ-ЯКИЙ СПІВАВТОР) БЕРЕТЕ НА СЕБЕ ВИТРАТИ ЗА БУДЬ-ЯКЕ НЕОБХІДНЕ ОБСЛУГОВУВАННЯ, РЕМОНТ ЧИ ВИПРАВЛЕННЯ. ЦЯ ВІДМОВА ВІД ГАРАНТІЙ СКЛАДАЄ ВАЖЛИВУ ЧАСТИНУ ЦІЄЇ ЛІЦЕНЗІЇ. НЕ ДОПУСКАЄТЬСЯ ВИКОРИСТАННЯ ЦЬОГО ДОКУМЕНТУ АБО ЙОГО ЗМІНЕНОЇ ВЕРСІЇ БЕЗ ПРИЙНЯТТЯ ЦІЄЇ ВІДМОВИ; ТА</p>
		</item>
		<item>
		  <p>НІ ЗА ЯКИХ ОБСТАВИН ТА ЗА БУДЬ-ЯКОГО ЗАКОНОДАВСТВА, ЧИ ТО ГРОМАДЯНСЬКОЇ ВІДПОВІДАЛЬНОСТІ (ВКЛЮЧАЮЧИ ХАЛАТНІСТЬ), ДОГОВОРУ, ЧИ ЧОГОСЬ ІНШОГО, АВТОР, ПОЧАТКОВИЙ УКЛАДАЧ, БУДЬ-ЯКИЙ СПІВАВТОР, АБО ДИСТРИБ'ЮТОР ДОКУМЕНТУ ЧИ ЗМІНЕНОЇ ВЕРСІЇ ДОКУМЕНТУ, АБО БУДЬ-ЯКИЙ ПОСТАЧАЛЬНИК БУДЬ-ЯКОЇ З ЦИХ СТОРІН, НЕ НЕСЕ ВІДПОВІДАЛЬНІСТЬ ПЕРЕД БУДЬ-ЯКОЮ ОСОБОЮ ЗА БУДЬ-ЯКІ ПРЯМІ, НЕПРЯМІ, ОСОБЛИВІ, ВИПАДКОВІ, АБО ІСТОТНІ ЗБИТКИ БУДЬ-ЯКОГО ХАРАКТЕРУ ВКЛЮЧАЮЧИ, АЛЕ НЕ ОБМЕЖУЮЧИСЬ, ЗБИТКАМИ ВІД ВТРАТИ ПРЕСТИЖУ, ЗУПИНКИ РОБОТИ, ЗБОЇВ АБО НЕСПРАВНОСТЕЙ КОМП'ЮТЕРА, АБО БУДЬ-ЯКІ ІНШІ ЗБИТКИ АБО ВТРАТИ, ЩО ВИНИКЛИ БЕЗВІДНОСНО АБО ВНАСЛІДОК ВИКОРИСТАННЯ ЦЬОГО ДОКУМЕНТУ ТА ЗМІНЕНИХ ВЕРСІЙ ЦЬОГО ДОКУМЕНТУ, НАВІТЬ ЯКЩО ЦІ СТОРОНИ, МОЖЛИВО, БУЛИ ПРОІНФОРМОВАНІ ПРО МОЖЛИВІСТЬ ТАКИХ ЗБИТКІВ.</p>
		</item>
	  </list>
</license>
</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">Гаразд</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>--window-icon</cmd>=<var>шлях_до_піктограми</var></title>
	<p>Вказує значок, який буде показано у рамці діалогового вікна. Є 4 вбудовані значки, які вказуються ключовими словами «info», «warning», «question» та «error».</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>
