| pekwm_dialog(1) | راهنمای کاربر | pekwm_dialog(1) |
نام (NAME)
pekwm_dialog - برنامه‌ای برای ایجاد کادرهای محاوره‌ای با الهام از xmessage
خلاصه دستور (SYNOPSIS)
pekwm_dialog [--display] message
توضیحات (DESCRIPTION)
دستور pekwm_dialog یک کادر محاوره‌ای ساده شامل یک عنوان، تصویر، متن پیام و یک دکمه به ازای هر گزینه‌ی مشخص‌شده را نمایش می‌دهد. اگر هیچ گزینه‌ای تعیین نشود، کادر محاوره‌ای با یک دکمه‌ی Ok نمایش داده خواهد شد.
فراخواننده می‌تواند با بررسی کد خروج برنامه تشخیص دهد کدام گزینه انتخاب شده است. گزینه‌ی نخست با کد وضعیت 0، گزینه‌ی بعدی با 1 و به همین ترتیب خارج خواهد شد.
با توجه به این رفتار، پیشنهاد می‌شود که ok به عنوان گزینه‌ی نخست، سپس cancel به عنوان گزینه‌ی دوم و پس از آن سایر گزینه‌ها قرار گیرند. این کار باعث می‌شود برای ok وضعیت خروج استاندارد 0 ثبت شود و cancel نیز کد خروجی مشابه با حالت بروز خطا داشته باشد.
طرح زیر چیدمان عناصر کادر محاوره‌ای را نشان می‌دهد:
-------------------------------------------- | TITLE | -------------------------------------------- | | | Image if any is displayed here | | | -------------------------------------------- | Message text goes here | | | -------------------------------------------- | [Option1] [Option2] | --------------------------------------------
گزینه‌ها (OPTIONS)
--help نمایش اطلاعات راهنما.
--display DISPLAY اتصال به DISPLAY به‌جای DISPLAY تنظیم‌شده در متغیرهای محیطی.
--geometry GEOMETRY ابعاد و موقعیت پنجره؛ مقدار پیش‌فرض 200x50 است که متناسب با اندازه‌ی تصویر گسترش می‌یابد.
--image IMAGE مسیر تصویر جهت نمایش.
--option STRING عنوان گزینه؛ پشتیبانی از چندین گزینه امکان‌پذیر است.
--title STRING رشته‌ی عنوان پنجره.
| فوریه 2021 | pekwm_dialog |