.nh
.TH pekwm\_dialog 1 "فوریه 2021" pekwm\_dialog "راهنمای کاربر"

.SH "نام (NAME)"
.PP
pekwm\_dialog \- برنامه‌ای برای ایجاد کادرهای محاوره‌ای با الهام از xmessage


.SH "خلاصه دستور (SYNOPSIS)"
.PP
pekwm\_dialog [\-\-display] message


.SH "توضیحات (DESCRIPTION)"
.PP
دستور pekwm\_dialog یک کادر محاوره‌ای ساده شامل یک عنوان، تصویر، متن پیام و یک دکمه به ازای هر گزینه‌ی مشخص‌شده را نمایش می‌دهد. اگر هیچ گزینه‌ای تعیین نشود، کادر محاوره‌ای با یک دکمه‌ی Ok نمایش داده خواهد شد.

.PP
فراخواننده می‌تواند با بررسی کد خروج برنامه تشخیص دهد کدام گزینه انتخاب شده است. گزینه‌ی نخست با کد وضعیت 0، گزینه‌ی بعدی با 1 و به همین ترتیب خارج خواهد شد.

.PP
با توجه به این رفتار، پیشنهاد می‌شود که ok به عنوان گزینه‌ی نخست، سپس cancel به عنوان گزینه‌ی دوم و پس از آن سایر گزینه‌ها قرار گیرند. این کار باعث می‌شود برای ok وضعیت خروج استاندارد 0 ثبت شود و cancel نیز کد خروجی مشابه با حالت بروز خطا داشته باشد.

.PP
طرح زیر چیدمان عناصر کادر محاوره‌ای را نشان می‌دهد:

.PP
.RS

.nf
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
| TITLE                                    |
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|                                          |
| Image if any is displayed here           |
|                                          |
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
| Message text goes here                   |
|                                          |
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|           [Option1] [Option2]            |
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

.fi
.RE


.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-help\fP نمایش اطلاعات راهنما.

.PP
\fB\-\-display\fP \fIDISPLAY\fP اتصال به DISPLAY به‌جای DISPLAY تنظیم‌شده در متغیرهای محیطی.

.PP
\fB\-\-geometry\fP \fIGEOMETRY\fP ابعاد و موقعیت پنجره؛ مقدار پیش‌فرض 200x50 است که متناسب با اندازه‌ی تصویر گسترش می‌یابد.

.PP
\fB\-\-image\fP \fIIMAGE\fP مسیر تصویر جهت نمایش.

.PP
\fB\-\-option\fP \fISTRING\fP عنوان گزینه؛ پشتیبانی از چندین گزینه امکان‌پذیر است.

.PP
\fB\-\-title\fP \fISTRING\fP رشته‌ی عنوان پنجره.