Használat

A Zenity segítségével egyszerű grafikus párbeszédablakokat hozhat létre. Kelemen Gábor kelemeng at gnome dot hu 2012, 2014. Használat

Parancsfájlok írásakor a Zenity segítségével egyszerű grafikus párbeszédablakokat hozhat létre, amelyek a következőképpen kommunikálnak a felhasználóval:

Létrehozhat egy ablakot, amelyben információkat kér a felhasználótól. Megkérheti például a felhasználót egy dátum kiválasztására a dátumválasztó ablakból, vagy fájl kiválasztására a fájlválasztó ablakból.

Létrehozhat egy ablakot, amelyben információkat ad a felhasználónak. Egy folyamatjelző ablak használatával például jelezheti egy művelet aktuális állapotát, vagy egy figyelmeztető ablakkal felhívhatja valamire a felhasználó figyelmét.

Amikor a felhasználó bezárja az ablakot, a Zenity kiírja az ablak által visszaadott szöveget a szabványos kimenetre.

Amikor Zenity parancsokat ír, mindig tegye idézőjelek közé az egyes argumentumokat.

Például így:

zenity --calendar --title="Szabadság tervezése"

Ne használja így:

zenity --calendar --title=Szabadság tervezése

Ha nem használ idézőjeleket, akkor váratlan eredményeket kaphat.

Hívóbetűk

A hívóbetű lehetővé teszi egy művelet végrehajtását a billentyűzetről, így nem muszáj mindig az egérrel kiválasztania a parancsot a menüből vagy ablakból. A hívóbetűk a menüpontok vagy beállítások szövegének aláhúzott betűi.

Egyes Zenity ablakok támogatják a hívóbetűk használatát. A hívóbetűként használandó karakter megadásához helyezzen el egy aláhúzást az ablak szövegében. A következő példa bemutatja, hogyan adhatja meg a „V” betűt hívóbetűként:

"_Válasszon egy nevet."

Kilépési kódok

A Zenity a következő kilépési kódokat adja vissza:

Kilépési kód	Leírás
`0`	A felhasználó megnyomta az OK vagy a Bezárás gombot.
`1`	A felhasználó megnyomta a Mégse gombot, vagy az ablakvezérlő elemekkel bezárta az ablakot.
`-1`	Váratlan hiba történt.
`5`	Az ablak az időkorlát elérése miatt bezárva.

Általános beállítások

Minden Zenity ablak támogatja a következő általános beállításokat:

<cmd>--title</cmd>=<var>cím</var>

Az ablak címének megadása.

<cmd>--window-icon</cmd>=<var>ikonútvonal</var>

Az ablakkeretben megjelenő ikon megadása. A következő kulcsszavak megadásával elérhető 4 alapértelmezett ikon is: „info”, „warning” (figyelmeztetés), „question” (kérdés) és „error” (hiba).

<cmd>--width</cmd>=<var>szélesség</var>

Az ablak szélességének megadása.

<cmd>--height</cmd>=<var>magasság</var>

Az ablak magasságának megadása.

<cmd>--timeout</cmd>=<var>időkorlát</var>

Időkorlát megadása másodpercben, amely után az ablak bezárandó.

Súgólehetőségek

A Zenity a következő súgólehetőségeket biztosítja:

Rövid súgószöveg megjelenítése.

Részletes súgószöveg megjelenítése minden ablakhoz.

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

Súgószöveg megjelenítése az általános ablakbeállításokhoz.

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

Súgószöveg megjelenítése a naptár ablak beállításaihoz.

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

Súgószöveg megjelenítése a szövegbeviteli ablak beállításaihoz.

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

Súgószöveg megjelenítése a hibaablak beállításaihoz.

Súgószöveg megjelenítése az információs ablak beállításaihoz.

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

Súgószöveg megjelenítése a fájlválasztó ablak beállításaihoz.

Súgószöveg megjelenítése a lista ablak beállításaihoz.

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

Súgószöveg megjelenítése az értesítési ikon beállításaihoz.

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

Súgószöveg megjelenítése a folyamatjelző ablak beállításaihoz.

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

Súgószöveg megjelenítése a kérdés ablak beállításaihoz.

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

Súgószöveg megjelenítése a figyelmeztető ablak beállításaihoz.

Súgószöveg megjelenítése a szöveges információs ablak beállításaihoz.

Súgószöveg megjelenítése egyéb beállításokhoz.

Súgószöveg megjelenítése a GTK+ beállításokhoz.

Egyéb beállítások

A Zenity a következő egyéb beállításokat is biztosítja:

<cmd>--about</cmd>

Megjeleníti a Zenity névjegye ablakot, amely verzió-, szerzői jogi és fejlesztői információkat tartalmaz.

<cmd>--version</cmd>

A Zenity verziószámának megjelenítése.

GTK+ beállításai

A Zenity támogatja a szabványos GTK+ beállításokat. A GTK+ beállításokkal kapcsolatos további információkért adja ki a zenity --help-gtk parancsot.

Környezeti változók

Általában a Zenity felismeri azt a terminálablakot, amelyből elindították, és azon ablak fölött tartja magát. Ez a viselkedés letiltható a WINDOWID környezeti változó törlésével.