| 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
- تنظیم قالب تاریخ بازگردانده‌شده
گزینه‌های متفرقه
گزینه‌های برنامه (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)
| March 2026 | zenity 4.2.2 |