.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH ZENITY "1" "March 2026" "zenity 4.2.2" "User Commands"
.SH "نام (NAME)"
zenity \- نمایش کادرهای محاوره‌ای GTK+ در اسکریپت‌های شل
.SH "توضیحات (DESCRIPTION)"

برنامهٔ \fBzenity\fP کادرهای محاوره‌ای GTK+ را نمایش می‌دهد و ورودی کاربر را (از طریق کد بازگشتی یا روی خروجی استاندارد) برمی‌گرداند. این قابلیت به شما امکان می‌دهد در انواع اسکریپت‌های شل، اطلاعات را به کاربر نمایش داده یا از او ورودی دریافت کنید.
.PP
برای نمونه، \fBzenity \-\-question\fP بسته به اینکه کاربر دکمهٔ \fIOK\fP یا \fICancel\fP را فشار دهد یا مهلت زمانی به پایان برسد، یکی از مقادیر 0، 1 یا 5 را بازمی‌گرداند. دستور \fBzenity \-\-entry\fP نیز آنچه را که کاربر در فیلد ورودی متن تایپ کرده است، در خروجی استاندارد چاپ می‌کند.
.PP
مستندات جامع در مرورگر راهنمای گنوم (GNOME Help Browser) نیز در دسترس است.
.SS "کاربرد (Usage):"
.IP
zenity [OPTION???]
.SS "گزینه‌های راهنما (Help Options):"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش گزینه‌های راهنما
.TP
\fB\-\-help\-all\fR
نمایش تمام گزینه‌های راهنما
.TP
\fB\-\-help\-general\fR
نمایش گزینه‌های عمومی
.TP
\fB\-\-help\-calendar\fR
نمایش گزینه‌های تقویم
.TP
\fB\-\-help\-entry\fR
نمایش گزینه‌های ورودی متن
.TP
\fB\-\-help\-error\fR
نمایش گزینه‌های خطا
.TP
\fB\-\-help\-info\fR
نمایش گزینه‌های اطلاعات
.TP
\fB\-\-help\-file\-selection\fR
نمایش گزینه‌های انتخاب فایل
.TP
\fB\-\-help\-list\fR
نمایش گزینه‌های فهرست
.TP
\fB\-\-help\-notification\fR
نمایش گزینه‌های اعلان
.TP
\fB\-\-help\-progress\fR
نمایش گزینه‌های پیشرفت
.TP
\fB\-\-help\-question\fR
نمایش گزینه‌های پرسش
.TP
\fB\-\-help\-warning\fR
نمایش گزینه‌های هشدار
.TP
\fB\-\-help\-scale\fR
نمایش گزینه‌های مقیاس
.TP
\fB\-\-help\-text\-info\fR
نمایش گزینه‌های اطلاعات متنی
.TP
\fB\-\-help\-color\-selection\fR
نمایش گزینه‌های انتخاب رنگ
.TP
\fB\-\-help\-password\fR
نمایش گزینه‌های کادر گذرواژه
.TP
\fB\-\-help\-forms\fR
نمایش گزینه‌های کادر فرم‌ها
.TP
\fB\-\-help\-misc\fR
نمایش گزینه‌های متفرقه
.PP
گزینه‌های عمومی
.TP
\fB\-\-title\fR=\fI\,TITLE\/\fR
تنظیم عنوان کادر محاوره‌ای
.TP
\fB\-\-width\fR=\fI\,WIDTH\/\fR
تنظیم پهنا
.TP
\fB\-\-height\fR=\fI\,HEIGHT\/\fR
تنظیم ارتفاع
.TP
\fB\-\-timeout\fR=\fI\,TIMEOUT\/\fR
تنظیم مهلت زمانی کادر محاوره‌ای بر حسب ثانیه
.TP
\fB\-\-ok\-label\fR=\fI\,TEXT\/\fR
تنظیم برچسب دکمهٔ OK
.TP
\fB\-\-cancel\-label\fR=\fI\,TEXT\/\fR
تنظیم برچسب دکمهٔ Cancel
.TP
\fB\-\-extra\-button\fR=\fI\,TEXT\/\fR
افزودن یک دکمهٔ اضافی
.TP
\fB\-\-modal\fR
تنظیم وضعیت پنجرهٔ مودال (modal)
.TP
\fB\-\-attach\fR=\fI\,WINDOW\/\fR
منسوخ‌شده؛ هیچ کاری انجام نمی‌دهد
.PP
گزینه‌های تقویم
.TP
\fB\-\-text\fR=\fI\,TEXT\/\fR
تنظیم متن کادر محاوره‌ای
.TP
\fB\-\-day\fR=\fI\,DAY\/\fR
تنظیم روز تقویم
.TP
\fB\-\-month\fR=\fI\,MONTH\/\fR
تنظیم ماه تقویم
.TP
\fB\-\-year\fR=\fI\,YEAR\/\fR
تنظیم سال تقویم
.TP
\fB\-\-date\-format\fR=\fI\,PATTERN\/\fR
تنظیم قالب تاریخ بازگردانده‌شده
.PP
گزینه‌های ورودی متن
.TP
\fB\-\-text\fR=\fI\,TEXT\/\fR
تنظیم متن کادر محاوره‌ای
.TP
\fB\-\-entry\-text\fR=\fI\,TEXT\/\fR
تنظیم متن اولیهٔ ورودی
.TP
\fB\-\-hide\-text\fR
پنهان کردن متن ورودی
.PP
گزینه‌های خطا
.TP
\fB\-\-text\fR=\fI\,TEXT\/\fR
تنظیم متن کادر محاوره‌ای
.TP
\fB\-\-icon\fR=\fI\,ICON\-NAME\/\fR
تنظیم نام آیکون
.TP
\fB\-\-no\-wrap\fR
غیرفعال‌سازی شکست خودکار خطوط متن
.TP
\fB\-\-no\-markup\fR
غیرفعال‌سازی نشانه‌گذاری Pango
.TP
\fB\-\-ellipsize\fR
فعال‌سازی کوتاه‌سازی متن با علامت تعلیق (...) در متن کادر محاوره‌ای؛ این گزینه مشکل ابعاد بیش از حد بزرگ پنجره در متن‌های طولانی را حل می‌کند
.PP
گزینه‌های اطلاعات
.TP
\fB\-\-text\fR=\fI\,TEXT\/\fR
تنظیم متن کادر محاوره‌ای
.TP
\fB\-\-icon\fR=\fI\,ICON\-NAME\/\fR
تنظیم نام آیکون
.TP
\fB\-\-no\-wrap\fR
غیرفعال‌سازی شکست خودکار خطوط متن
.TP
\fB\-\-no\-markup\fR
غیرفعال‌سازی نشانه‌گذاری Pango
.TP
\fB\-\-ellipsize\fR
فعال‌سازی کوتاه‌سازی متن با علامت تعلیق (...) در متن کادر محاوره‌ای؛ این گزینه مشکل ابعاد بیش از حد بزرگ پنجره در متن‌های طولانی را حل می‌کند
.PP
گزینه‌های انتخاب فایل
.TP
\fB\-\-filename\fR=\fI\,FILENAME\/\fR
تنظیم نام فایل
.TP
\fB\-\-multiple\fR
امکان انتخاب هم‌زمان چندین فایل
.TP
\fB\-\-directory\fR
فعال‌سازی حالت انتخاب صرفاً دایرکتوری
.TP
\fB\-\-save\fR
فعال‌سازی حالت ذخیره فایل
.TP
\fB\-\-separator\fR=\fI\,SEPARATOR\/\fR
تنظیم نویسهٔ جداکننده در خروجی
.TP
\fB\-\-file\-filter\fR=\fI\,NAME\/\fR | PATTERN1 PATTERN2 ...
تنظیم فیلتر نام فایل
.TP
\fB\-\-confirm\-overwrite\fR
منسوخ‌شده؛ هیچ کاری انجام نمی‌دهد
.PP
گزینه‌های فهرست
.TP
\fB\-\-text\fR=\fI\,TEXT\/\fR
تنظیم متن کادر محاوره‌ای
.TP
\fB\-\-column\fR=\fI\,COLUMN\/\fR
تنظیم سرستون
.TP
\fB\-\-checklist\fR
استفاده از کادرهای انتخاب (checkbox) برای ستون اول
.TP
\fB\-\-radiolist\fR
استفاده از دکمه‌های رادیویی (radio button) برای ستون اول
.TP
\fB\-\-imagelist\fR
استفاده از تصویر برای ستون اول
.TP
\fB\-\-separator\fR=\fI\,SEPARATOR\/\fR
تنظیم نویسهٔ جداکننده در خروجی
.TP
\fB\-\-multiple\fR
امکان انتخاب هم‌زمان چندین سطر
.TP
\fB\-\-editable\fR
امکان ویرایش متن
.TP
\fB\-\-print\-column\fR=\fI\,NUMBER\/\fR
چاپ ستونی مشخص (پیش‌فرض 1 است. از 'ALL' می‌توان برای چاپ تمامی ستون‌ها استفاده کرد)
.TP
\fB\-\-hide\-column\fR=\fI\,NUMBER\/\fR
پنهان کردن ستونی مشخص
.TP
\fB\-\-hide\-header\fR
پنهان کردن سرستون‌ها
.TP
\fB\-\-mid\-search\fR
منسوخ‌شده؛ هیچ کاری انجام نمی‌دهد
.PP
گزینه‌های اعلان
.TP
\fB\-\-text\fR=\fI\,TEXT\/\fR
تنظیم متن اعلان
.TP
\fB\-\-icon\fR=\fI\,ICON\-NAME\/\fR
تنظیم نام آیکون
.TP
\fB\-\-listen\fR
شنود دستورها از طریق ورودی استاندارد (stdin)
.TP
\fB\-\-hint\fR=\fI\,TEXT\/\fR
منسوخ‌شده؛ هیچ کاری انجام نمی‌دهد
.PP
گزینه‌های پیشرفت
.TP
\fB\-\-text\fR=\fI\,TEXT\/\fR
تنظیم متن کادر محاوره‌ای
.TP
\fB\-\-percentage\fR=\fI\,PERCENTAGE\/\fR
تنظیم درصد اولیه
.TP
\fB\-\-pulsate\fR
حرکت پالس‌زن نوار پیشرفت (رفت‌وبرگشتی)
.TP
\fB\-\-auto\-close\fR
بستن خودکار کادر محاوره‌ای پس از رسیدن به ۱۰۰٪
.TP
\fB\-\-auto\-kill\fR
خاتمه دادن به فرایند والد در صورت فشرده شدن دکمهٔ Cancel
.TP
\fB\-\-no\-cancel\fR
پنهان کردن دکمهٔ Cancel
.TP
\fB\-\-time\-remaining\fR
تخمین زمان باقی‌مانده تا رسیدن نوار پیشرفت به ۱۰۰٪
.PP
گزینه‌های پرسش
.TP
\fB\-\-text\fR=\fI\,TEXT\/\fR
تنظیم متن کادر محاوره‌ای
.TP
\fB\-\-icon\fR=\fI\,ICON\-NAME\/\fR
تنظیم نام آیکون
.TP
\fB\-\-no\-wrap\fR
غیرفعال‌سازی شکست خودکار خطوط متن
.TP
\fB\-\-no\-markup\fR
غیرفعال‌سازی نشانه‌گذاری Pango
.TP
\fB\-\-default\-cancel\fR
قرار دادن فوکوس پیش‌فرض روی دکمهٔ Cancel
.TP
\fB\-\-ellipsize\fR
فعال‌سازی کوتاه‌سازی متن با علامت تعلیق (...) در متن کادر محاوره‌ای؛ این گزینه مشکل ابعاد بیش از حد بزرگ پنجره در متن‌های طولانی را حل می‌کند
.TP
\fB\-\-switch\fR
حذف دکمه‌های OK و Cancel
.PP
گزینه‌های هشدار
.TP
\fB\-\-text\fR=\fI\,TEXT\/\fR
تنظیم متن کادر محاوره‌ای
.TP
\fB\-\-icon\fR=\fI\,ICON\-NAME\/\fR
تنظیم نام آیکون
.TP
\fB\-\-no\-wrap\fR
غیرفعال‌سازی شکست خودکار خطوط متن
.TP
\fB\-\-no\-markup\fR
غیرفعال‌سازی نشانه‌گذاری Pango
.TP
\fB\-\-ellipsize\fR
فعال‌سازی کوتاه‌سازی متن با علامت تعلیق (...) در متن کادر محاوره‌ای؛ این گزینه مشکل ابعاد بیش از حد بزرگ پنجره در متن‌های طولانی را حل می‌کند
.PP
گزینه‌های مقیاس
.TP
\fB\-\-text\fR=\fI\,TEXT\/\fR
تنظیم متن کادر محاوره‌ای
.TP
\fB\-\-value\fR=\fI\,VALUE\/\fR
تنظیم مقدار اولیه
.TP
\fB\-\-min\-value\fR=\fI\,VALUE\/\fR
تنظیم مقدار کمینه
.TP
\fB\-\-max\-value\fR=\fI\,VALUE\/\fR
تنظیم مقدار بیشینه
.TP
\fB\-\-step\fR=\fI\,VALUE\/\fR
تنظیم اندازهٔ گام
.TP
\fB\-\-print\-partial\fR
چاپ مقادیر جزئی و میانی
.TP
\fB\-\-hide\-value\fR
پنهان کردن مقدار
.PP
گزینه‌های اطلاعات متنی
.TP
\fB\-\-filename\fR=\fI\,FILENAME\/\fR
باز کردن فایل
.TP
\fB\-\-editable\fR
امکان ویرایش متن
.TP
\fB\-\-font\fR=\fI\,TEXT\/\fR
تنظیم قلم (فونت) متن
.TP
\fB\-\-checkbox\fR=\fI\,TEXT\/\fR
فعال‌سازی کادر تأیید «خواندم و موافقم»
.TP
\fB\-\-auto\-scroll\fR
پیمایش خودکار متن تا انتها؛ تنها هنگامی که متن از stdin دریافت شود
.PP
گزینه‌های انتخاب رنگ
.TP
\fB\-\-color\fR=\fI\,VALUE\/\fR
تنظیم رنگ
.TP
\fB\-\-show\-palette\fR
نمایش پالت رنگ
.PP
گزینه‌های کادر گذرواژه
.TP
\fB\-\-username\fR
نمایش گزینهٔ نام کاربری
.PP
گزینه‌های کادر فرم‌ها
.TP
\fB\-\-add\-entry\fR=\fI\,Field\/\fR name
افزودن یک فیلد ورودی (Entry) جدید در کادر محاوره‌ای فرم‌ها
.TP
\fB\-\-add\-password\fR=\fI\,Field\/\fR name
افزودن یک ورودی گذرواژه جدید در کادر محاوره‌ای فرم‌ها
.TP
\fB\-\-add\-multiline\-entry\fR=\fI\,Field\/\fR name
افزودن یک فیلد ورودی چندخطی جدید در کادر محاوره‌ای فرم‌ها (از نسخه: 4.2)
.TP
\fB\-\-add\-calendar\fR=\fI\,Calendar\/\fR field name
افزودن یک تقویم جدید در کادر محاوره‌ای فرم‌ها
.TP
\fB\-\-add\-list\fR=\fI\,List\/\fR field and header name
افزودن یک فهرست جدید در کادر محاوره‌ای فرم‌ها
.TP
\fB\-\-list\-values\fR=\fI\,List\/\fR of values separated by |
فهرست مقادیر برای کادر فهرست (جداشده با |)
.TP
\fB\-\-column\-values\fR=\fI\,List\/\fR of values separated by |
فهرست مقادیر برای ستون‌ها (جداشده با |)
.TP
\fB\-\-add\-combo\fR=\fI\,Combo\/\fR box field name
افزودن یک جعبهٔ گزینش بازشو (combo box) در کادر محاوره‌ای فرم‌ها
.TP
\fB\-\-combo\-values\fR=\fI\,List\/\fR of values separated by |
فهرست مقادیر برای جعبهٔ بازشو (جداشده با |)
.TP
\fB\-\-show\-header\fR
نمایش سرستون‌ها
.TP
\fB\-\-text\fR=\fI\,TEXT\/\fR
تنظیم متن کادر محاوره‌ای
.TP
\fB\-\-separator\fR=\fI\,SEPARATOR\/\fR
تنظیم نویسهٔ جداکننده در خروجی
.TP
\fB\-\-forms\-date\-format\fR=\fI\,PATTERN\/\fR
تنظیم قالب تاریخ بازگردانده‌شده
.PP
گزینه‌های متفرقه
.TP
\fB\-\-about\fR
دربارهٔ zenity
.TP
\fB\-\-version\fR
نمایش نسخهٔ برنامه
.SS "گزینه‌های برنامه (Application Options):"
.TP
\fB\-\-calendar\fR
نمایش کادر محاوره‌ای تقویم
.TP
\fB\-\-entry\fR
نمایش کادر محاوره‌ای ورودی متن
.TP
\fB\-\-error\fR
نمایش کادر محاوره‌ای خطا
.TP
\fB\-\-info\fR
نمایش کادر محاوره‌ای اطلاعات
.TP
\fB\-\-file\-selection\fR
نمایش کادر محاوره‌ای انتخاب فایل
.TP
\fB\-\-list\fR
نمایش کادر محاوره‌ای فهرست
.TP
\fB\-\-notification\fR
نمایش اعلان
.TP
\fB\-\-progress\fR
نمایش کادر محاوره‌ای نوار پیشرفت
.TP
\fB\-\-question\fR
نمایش کادر محاوره‌ای پرسش
.TP
\fB\-\-warning\fR
نمایش کادر محاوره‌ای هشدار
.TP
\fB\-\-scale\fR
نمایش کادر محاوره‌ای مقیاس
.TP
\fB\-\-text\-info\fR
نمایش کادر محاوره‌ای اطلاعات متنی
.TP
\fB\-\-color\-selection\fR
نمایش کادر محاوره‌ای انتخاب رنگ
.TP
\fB\-\-password\fR
نمایش کادر محاوره‌ای گذرواژه
.TP
\fB\-\-forms\fR
نمایش کادر محاوره‌ای فرم‌ها
.SH "مثال‌ها (EXAMPLES)"

نمایش یک انتخاب‌گر فایل با عنوان \fISelect a file to remove\fP. فایل انتخاب‌شده در خروجی استاندارد بازگردانده می‌شود.
.IP
zenity  \-\-title="Select a file to remove" \-\-file-selection
.PP
نمایش یک کادر محاوره‌ای ورود متن با عنوان \fISelect Host\fP و متن \fISelect the host you would like to flood-ping\fP. متن واردشده در خروجی استاندارد چاپ می‌شود.
.IP
zenity  \-\-title "Select Host" \-\-entry \-\-text "Select the host you would like to flood-ping"
.PP
نمایش کادر محاوره‌ای با پرسش \fIMicrosoft Windows has been found! Would you like to remove it?\fP. در صورت انتخاب دکمهٔ \fIOK\fP، کد بازگشتی 0 (درست در شل) و در صورت انتخاب \fICancel\fP برابر 1 (نادرست) خواهد بود.
.IP
zenity  \-\-question \-\-title "Alert"  \-\-text "Microsoft Windows has been found! Would you like to remove it?"
.PP
نمایش نتایج جست‌وجو در یک کادر محاوره‌ای فهرست با عنوان \fISearch Results\fP و متن \fIFinding all header files...\fP.
.IP
find . \-name '*.h' | zenity \-\-list \-\-title "Search Results" \-\-text "Finding all header files.." \-\-column "Files"
.PP
نمایش یک اعلان غیرفعال (passive notification)
.IP
zenity \-\-notification \-\-icon=software-update-available \-\-text "System update necessary!"
.PP
نمایش فهرست خرید هفتگی در یک کادر فهرستی انتخابی (checklist) همراه با انتخاب پیش‌فرض گزینه‌های \fIApples\fP و \fIOranges\fP
.IP
zenity \-\-list \-\-checklist \-\-column "Buy" \-\-column "Item" TRUE Apples TRUE Oranges FALSE Pears FALSE Toothpaste
.PP
نمایش کادر محاوره‌ای نوار پیشرفت هنگام جست‌وجوی تمامی فایل‌های postscript در دایرکتوری خانگی
.P
find $HOME \-name '*.ps' | zenity \-\-progress \-\-pulsate
.SH "نویسندگان (AUTHORS)"

.PP
برنامهٔ \fBZenity\fP در ابتدا توسط Glynn Foster <glynn.foster@sun.com> نوشته شد و از آن زمان تاکنون توسط شمار زیادی از مشارکت‌کنندگان نگهداری شده است.
.PP
این صفحهٔ راهنما در ابتدا توسط Ross Burton <ross@burtonini.com> نوشته شد. در حال حاضر بخش‌هایی از آن به صورت خودکار تولید شده و سایر بخش‌ها را نویسندهٔ اصلی نگاشته است.
.SH "همچنین ببینید (SEE ALSO)"

\fBdialog\fP(1)