ZENITY(1)                        User Commands                       ZENITY(1)

نام (NAME)
       zenity - نمایش کادرهای محاوره‌ای GTK+ در اسکریپت‌های شل

توضیحات (DESCRIPTION)
       برنامهٔ zenity کادرهای محاوره‌ای GTK+ را نمایش می‌دهد و ورودی کاربر را (از
       طریق کد بازگشتی یا روی خروجی استاندارد) برمی‌گرداند. این قابلیت به شما
       امکان می‌دهد در انواع اسکریپت‌های شل، اطلاعات را به کاربر نمایش داده یا
       از او ورودی دریافت کنید.

       برای نمونه، zenity --question بسته به اینکه کاربر دکمهٔ OK یا Cancel را
       فشار دهد یا مهلت زمانی به پایان برسد، یکی از مقادیر 0، 1 یا 5 را
       بازمی‌گرداند. دستور zenity --entry نیز آنچه را که کاربر در فیلد ورودی
       متن تایپ کرده است، در خروجی استاندارد چاپ می‌کند.

       مستندات جامع در مرورگر راهنمای گنوم (GNOME Help Browser) نیز در دسترس
       است.

   کاربرد (Usage):
              zenity [OPTION???]

   گزینه‌های راهنما (Help Options):
       -h, --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-scale
              نمایش گزینه‌های مقیاس

       --help-text-info
              نمایش گزینه‌های اطلاعات متنی

       --help-color-selection
              نمایش گزینه‌های انتخاب رنگ

       --help-password
              نمایش گزینه‌های کادر گذرواژه

       --help-forms
              نمایش گزینه‌های کادر فرم‌ها

       --help-misc
              نمایش گزینه‌های متفرقه

       گزینه‌های عمومی

       --title=TITLE
              تنظیم عنوان کادر محاوره‌ای

       --width=WIDTH
              تنظیم پهنا

       --height=HEIGHT
              تنظیم ارتفاع

       --timeout=TIMEOUT
              تنظیم مهلت زمانی کادر محاوره‌ای بر حسب ثانیه

       --ok-label=TEXT
              تنظیم برچسب دکمهٔ OK

       --cancel-label=TEXT
              تنظیم برچسب دکمهٔ Cancel

       --extra-button=TEXT
              افزودن یک دکمهٔ اضافی

       --modal
              تنظیم وضعیت پنجرهٔ مودال (modal)

       --attach=WINDOW
              منسوخ‌شده؛ هیچ کاری انجام نمی‌دهد

       گزینه‌های تقویم

       --text=TEXT
              تنظیم متن کادر محاوره‌ای

       --day=DAY
              تنظیم روز تقویم

       --month=MONTH
              تنظیم ماه تقویم

       --year=YEAR
              تنظیم سال تقویم

       --date-format=PATTERN
              تنظیم قالب تاریخ بازگردانده‌شده

       گزینه‌های ورودی متن

       --text=TEXT
              تنظیم متن کادر محاوره‌ای

       --entry-text=TEXT
              تنظیم متن اولیهٔ ورودی

       --hide-text
              پنهان کردن متن ورودی

       گزینه‌های خطا

       --text=TEXT
              تنظیم متن کادر محاوره‌ای

       --icon=ICON-NAME
              تنظیم نام آیکون

       --no-wrap
              غیرفعال‌سازی شکست خودکار خطوط متن

       --no-markup
              غیرفعال‌سازی نشانه‌گذاری Pango

       --ellipsize
              فعال‌سازی کوتاه‌سازی متن با علامت تعلیق (...) در متن کادر
              محاوره‌ای؛ این گزینه مشکل ابعاد بیش از حد بزرگ پنجره در متن‌های
              طولانی را حل می‌کند

       گزینه‌های اطلاعات

       --text=TEXT
              تنظیم متن کادر محاوره‌ای

       --icon=ICON-NAME
              تنظیم نام آیکون

       --no-wrap
              غیرفعال‌سازی شکست خودکار خطوط متن

       --no-markup
              غیرفعال‌سازی نشانه‌گذاری Pango

       --ellipsize
              فعال‌سازی کوتاه‌سازی متن با علامت تعلیق (...) در متن کادر
              محاوره‌ای؛ این گزینه مشکل ابعاد بیش از حد بزرگ پنجره در متن‌های
              طولانی را حل می‌کند

       گزینه‌های انتخاب فایل

       --filename=FILENAME
              تنظیم نام فایل

       --multiple
              امکان انتخاب هم‌زمان چندین فایل

       --directory
              فعال‌سازی حالت انتخاب صرفاً دایرکتوری

       --save فعال‌سازی حالت ذخیره فایل

       --separator=SEPARATOR
              تنظیم نویسهٔ جداکننده در خروجی

       --file-filter=NAME | PATTERN1 PATTERN2 ...
              تنظیم فیلتر نام فایل

       --confirm-overwrite
              منسوخ‌شده؛ هیچ کاری انجام نمی‌دهد

       گزینه‌های فهرست

       --text=TEXT
              تنظیم متن کادر محاوره‌ای

       --column=COLUMN
              تنظیم سرستون

       --checklist
              استفاده از کادرهای انتخاب (checkbox) برای ستون اول

       --radiolist
              استفاده از دکمه‌های رادیویی (radio button) برای ستون اول

       --imagelist
              استفاده از تصویر برای ستون اول

       --separator=SEPARATOR
              تنظیم نویسهٔ جداکننده در خروجی

       --multiple
              امکان انتخاب هم‌زمان چندین سطر

       --editable
              امکان ویرایش متن

       --print-column=NUMBER
              چاپ ستونی مشخص (پیش‌فرض 1 است. از 'ALL' می‌توان برای چاپ تمامی
              ستون‌ها استفاده کرد)

       --hide-column=NUMBER
              پنهان کردن ستونی مشخص

       --hide-header
              پنهان کردن سرستون‌ها

       --mid-search
              منسوخ‌شده؛ هیچ کاری انجام نمی‌دهد

       گزینه‌های اعلان

       --text=TEXT
              تنظیم متن اعلان

       --icon=ICON-NAME
              تنظیم نام آیکون

       --listen
              شنود دستورها از طریق ورودی استاندارد (stdin)

       --hint=TEXT
              منسوخ‌شده؛ هیچ کاری انجام نمی‌دهد

       گزینه‌های پیشرفت

       --text=TEXT
              تنظیم متن کادر محاوره‌ای

       --percentage=PERCENTAGE
              تنظیم درصد اولیه

       --pulsate
              حرکت پالس‌زن نوار پیشرفت (رفت‌وبرگشتی)

       --auto-close
              بستن خودکار کادر محاوره‌ای پس از رسیدن به ۱۰۰٪

       --auto-kill
              خاتمه دادن به فرایند والد در صورت فشرده شدن دکمهٔ Cancel

       --no-cancel
              پنهان کردن دکمهٔ Cancel

       --time-remaining
              تخمین زمان باقی‌مانده تا رسیدن نوار پیشرفت به ۱۰۰٪

       گزینه‌های پرسش

       --text=TEXT
              تنظیم متن کادر محاوره‌ای

       --icon=ICON-NAME
              تنظیم نام آیکون

       --no-wrap
              غیرفعال‌سازی شکست خودکار خطوط متن

       --no-markup
              غیرفعال‌سازی نشانه‌گذاری Pango

       --default-cancel
              قرار دادن فوکوس پیش‌فرض روی دکمهٔ Cancel

       --ellipsize
              فعال‌سازی کوتاه‌سازی متن با علامت تعلیق (...) در متن کادر
              محاوره‌ای؛ این گزینه مشکل ابعاد بیش از حد بزرگ پنجره در متن‌های
              طولانی را حل می‌کند

       --switch
              حذف دکمه‌های OK و Cancel

       گزینه‌های هشدار

       --text=TEXT
              تنظیم متن کادر محاوره‌ای

       --icon=ICON-NAME
              تنظیم نام آیکون

       --no-wrap
              غیرفعال‌سازی شکست خودکار خطوط متن

       --no-markup
              غیرفعال‌سازی نشانه‌گذاری Pango

       --ellipsize
              فعال‌سازی کوتاه‌سازی متن با علامت تعلیق (...) در متن کادر
              محاوره‌ای؛ این گزینه مشکل ابعاد بیش از حد بزرگ پنجره در متن‌های
              طولانی را حل می‌کند

       گزینه‌های مقیاس

       --text=TEXT
              تنظیم متن کادر محاوره‌ای

       --value=VALUE
              تنظیم مقدار اولیه

       --min-value=VALUE
              تنظیم مقدار کمینه

       --max-value=VALUE
              تنظیم مقدار بیشینه

       --step=VALUE
              تنظیم اندازهٔ گام

       --print-partial
              چاپ مقادیر جزئی و میانی

       --hide-value
              پنهان کردن مقدار

       گزینه‌های اطلاعات متنی

       --filename=FILENAME
              باز کردن فایل

       --editable
              امکان ویرایش متن

       --font=TEXT
              تنظیم قلم (فونت) متن

       --checkbox=TEXT
              فعال‌سازی کادر تأیید «خواندم و موافقم»

       --auto-scroll
              پیمایش خودکار متن تا انتها؛ تنها هنگامی که متن از stdin دریافت
              شود

       گزینه‌های انتخاب رنگ

       --color=VALUE
              تنظیم رنگ

       --show-palette
              نمایش پالت رنگ

       گزینه‌های کادر گذرواژه

       --username
              نمایش گزینهٔ نام کاربری

       گزینه‌های کادر فرم‌ها

       --add-entry=Field name
              افزودن یک فیلد ورودی (Entry) جدید در کادر محاوره‌ای فرم‌ها

       --add-password=Field name
              افزودن یک ورودی گذرواژه جدید در کادر محاوره‌ای فرم‌ها

       --add-multiline-entry=Field name
              افزودن یک فیلد ورودی چندخطی جدید در کادر محاوره‌ای فرم‌ها (از
              نسخه: 4.2)

       --add-calendar=Calendar field name
              افزودن یک تقویم جدید در کادر محاوره‌ای فرم‌ها

       --add-list=List field and header name
              افزودن یک فهرست جدید در کادر محاوره‌ای فرم‌ها

       --list-values=List of values separated by |
              فهرست مقادیر برای کادر فهرست (جداشده با |)

       --column-values=List of values separated by |
              فهرست مقادیر برای ستون‌ها (جداشده با |)

       --add-combo=Combo box field name
              افزودن یک جعبهٔ گزینش بازشو (combo box) در کادر محاوره‌ای فرم‌ها

       --combo-values=List of values separated by |
              فهرست مقادیر برای جعبهٔ بازشو (جداشده با |)

       --show-header
              نمایش سرستون‌ها

       --text=TEXT
              تنظیم متن کادر محاوره‌ای

       --separator=SEPARATOR
              تنظیم نویسهٔ جداکننده در خروجی

       --forms-date-format=PATTERN
              تنظیم قالب تاریخ بازگردانده‌شده

       گزینه‌های متفرقه

       --about
              دربارهٔ zenity

       --version
              نمایش نسخهٔ برنامه

   گزینه‌های برنامه (Application Options):
       --calendar
              نمایش کادر محاوره‌ای تقویم

       --entry
              نمایش کادر محاوره‌ای ورودی متن

       --error
              نمایش کادر محاوره‌ای خطا

       --info نمایش کادر محاوره‌ای اطلاعات

       --file-selection
              نمایش کادر محاوره‌ای انتخاب فایل

       --list نمایش کادر محاوره‌ای فهرست

       --notification
              نمایش اعلان

       --progress
              نمایش کادر محاوره‌ای نوار پیشرفت

       --question
              نمایش کادر محاوره‌ای پرسش

       --warning
              نمایش کادر محاوره‌ای هشدار

       --scale
              نمایش کادر محاوره‌ای مقیاس

       --text-info
              نمایش کادر محاوره‌ای اطلاعات متنی

       --color-selection
              نمایش کادر محاوره‌ای انتخاب رنگ

       --password
              نمایش کادر محاوره‌ای گذرواژه

       --forms
              نمایش کادر محاوره‌ای فرم‌ها

مثال‌ها (EXAMPLES)
       نمایش یک انتخاب‌گر فایل با عنوان Select a file to remove. فایل انتخاب‌شده
       در خروجی استاندارد بازگردانده می‌شود.

              zenity  --title="Select a file to remove" --file-selection

       نمایش یک کادر محاوره‌ای ورود متن با عنوان Select Host و متن Select the
       host you would like to flood-ping. متن واردشده در خروجی استاندارد چاپ
       می‌شود.

              zenity  --title "Select Host" --entry --text "Select the host
              you would like to flood-ping"

       نمایش کادر محاوره‌ای با پرسش Microsoft Windows has been found! Would you
       like to remove it?. در صورت انتخاب دکمهٔ OK، کد بازگشتی 0 (درست در شل) و
       در صورت انتخاب Cancel برابر 1 (نادرست) خواهد بود.

              zenity  --question --title "Alert"  --text "Microsoft Windows
              has been found! Would you like to remove it?"

       نمایش نتایج جست‌وجو در یک کادر محاوره‌ای فهرست با عنوان Search Results و
       متن Finding all header files....

              find . -name '*.h' | zenity --list --title "Search Results"
              --text "Finding all header files.." --column "Files"

       نمایش یک اعلان غیرفعال (passive notification)

              zenity --notification --icon=software-update-available --text
              "System update necessary!"

       نمایش فهرست خرید هفتگی در یک کادر فهرستی انتخابی (checklist) همراه با
       انتخاب پیش‌فرض گزینه‌های Apples و Oranges

              zenity --list --checklist --column "Buy" --column "Item" TRUE
              Apples TRUE Oranges FALSE Pears FALSE Toothpaste

       نمایش کادر محاوره‌ای نوار پیشرفت هنگام جست‌وجوی تمامی فایل‌های postscript
       در دایرکتوری خانگی

       find $HOME -name '*.ps' | zenity --progress --pulsate

نویسندگان (AUTHORS)
       برنامهٔ Zenity در ابتدا توسط Glynn Foster <glynn.foster@sun.com> نوشته
       شد و از آن زمان تاکنون توسط شمار زیادی از مشارکت‌کنندگان نگهداری شده
       است.

       این صفحهٔ راهنما در ابتدا توسط Ross Burton <ross@burtonini.com> نوشته
       شد. در حال حاضر بخش‌هایی از آن به صورت خودکار تولید شده و سایر بخش‌ها را
       نویسندهٔ اصلی نگاشته است.

همچنین ببینید (SEE ALSO)
       dialog(1)

zenity 4.2.2                      March 2026                         ZENITY(1)