GXMESSAGE(1)                                                      GXMESSAGE(1)

نام (NAME)
       gxmessage - باز کردن کادرهای گفتگوی گرافیکی مبتنی بر GTK

خلاصه دستور (SYNOPSIS)
       gxmessage [گزینه‌ها] پیام ...
       gxmessage [گزینه‌ها] -file نام_فایل

توضیحات (DESCRIPTION)
       دستور gxmessage پنجره‌ای را برای نمایش پیامی که از خط فرمان، از یک فایل
       یا از ورودی استاندارد (stdin) دریافت شده باز می‌کند. این پنجره شامل
       ردیفی از دکمه‌ها است که هر یک از آن‌ها موجب خروج برنامه با یک کد بازگشتی
       متفاوت می‌شود.

       مدخل GNU Info برای gxmessage شامل اطلاعات و مثال‌های تفصیلی است.

گزینه‌ها (OPTIONS)
       دستور gxmessage هر گزینه‌ای را که xmessage بپذیرد قبول می‌کند؛ هرچند برخی
       گزینه‌ها (مانند -bw و -xrm) بدون هشدار نادیده گرفته می‌شوند.

       -bg COLOR
              رنگ پس‌زمینه پیام را روی COLOR تنظیم می‌کند. مثال‌ها: red،‏ "#c90"،‏
              "#446a7e".

       -buttons BUTTON_LIST
              دکمه‌هایی که باید ساخته شوند را تعریف می‌کند.  BUTTON_LIST فهرستی
              از جفت‌های LABEL:VALUE جداشده با کاما برای هر دکمه است.  LABEL
              متنی است که روی دکمه نمایش داده می‌شود.  VALUE (بین ۰ تا ۲۵۵) کدی
              است که برنامه در صورت فشرده شدن آن دکمه با آن خارج می‌شود. کاما و
              دونقطه را می‌توان با استفاده از بک‌اسلش (\) اسکیپ کرد. علاوه بر
              متن عادی، LABEL می‌تواند یک دکمه پیش‌ساخته (stock) در GTK مانند
              "GTK_STOCK_CANCEL" را مشخص کند، یا می‌تواند شامل یک خط زیرین (_)
              برای تعیین کلید میانبر صفحه‌کلید باشد. در صورت حذف VALUEها، آن‌ها
              به ترتیب روی ۱۰۱، ۱۰۲، ۱۰۳ و غیره پیش‌فرض می‌شوند. اگر گزینه
              -buttons داده نشود، BUTTON_LIST به طور پیش‌فرض برابر با "okay:0"
              خواهد بود.

                   gxmessage -buttons "Foo:42,Bar:63" "Example"
                   echo $?

                   gxmessage -buttons "_Foo,_Bar" "Example"
                   echo $?

                   gxmessage "Example"
                   echo $?

                   gxmessage -buttons "GTK_STOCK_OK:0" "Example"
                   echo $?

                   gxmessage -buttons "Hello\, world" "Example"


       -center
              پنجره gxmessage را در وسط صفحه نمایش باز می‌کند.

       -default LABEL
              پنجره gxmessage را با تمرکز ورودی روی دکمه مشخص‌شده باز می‌کند.
              LABEL یکی از برچسب‌های موجود در BUTTON_LIST است (گزینه -buttons
              در بالا را ببینید).

       -display DISPLAY
              نمایشگر X مورد استفاده را مشخص می‌کند.

       -fg COLOR
              رنگ متن پیام را روی COLOR تنظیم می‌کند.

       -file FILENAME
              موجب می‌شود تا فایل نام‌برده‌شده به عنوان منبع پیام استفاده شود.
              اگر خط تیره (-) به جای FILENAME به کار رود، پیام از ورودی
              استاندارد (stdin) خوانده می‌شود.

       -fn | -font FONT
              قلم پیام را با استفاده از سیستم تعیین قلم GTK مشخص می‌کند؛ برای
              نمونه، -font "serif italic 14".  (سیستم قلم GTK با xmessage
              سازگار نیست. بخش سازگاری در ادامه را برای راهکار جایگزین
              ببینید.)

       -geometry GEOMETRY
              اندازه یا موقعیت پنجره را تنظیم می‌کند. مثال‌ها:

                   -geometry 400x200
                   -geometry 400x200+600+100
                   -geometry +600+100


       -help
              اطلاعات پایه نحوه استفاده را نمایش داده و خارج می‌شود.

       -iconic
              پنجره gxmessage را در حالت کمینه‌شده (آیکون) باز می‌کند.

       -name NAME
              نام پنجره gxmessage را روی NAME تنظیم می‌کند.

       -nearmouse
              پنجره gxmessage را در نزدیکی نشانگر موش باز می‌کند.

       -print
              مقدار LABEL دکمه انتخاب‌شده را در خروجی استاندارد (stdout)
              می‌نویسد.

       -timeout SECONDS
              اگر هیچ دکمه‌ای در طول SECONDS ثانیه فشرده نشود، پنجره gxmessage
              را به طور خودکار با کد خروج ۰ می‌بندد. (گزینه‌های -entry و
              -entrytext موجب نادیده گرفته شدن -timeout می‌شوند.)

       -title TITLE
              عنوان پنجره gxmessage را روی TITLE تنظیم می‌کند.

گزینه‌های ویژه GXMESSAGE (GXMESSAGE SPECIFIC OPTIONS)
       گزینه‌های زیر مختص gxmessage هستند و با xmessage سازگاری ندارند.

       -borderless
              پنجره gxmessage را بدون قاب معمول پنجره باز می‌کند.

       -encoding CHARSET
              کدگذاری نویسه‌های متن پیام را مشخص می‌کند. به طور پیش‌فرض، فرض
              می‌شود که متن پیام با کدگذاری محلی جاری (locale) مطابقت دارد.

       -entry
              یک کادر ورود متن به پنجره gxmessage اضافه می‌کند. هنگام بسته شدن
              پنجره، هر متنی در کادر ورود متن در خروجی استاندارد (stdout) کپی
              می‌شود. این گزینه را نمی‌توان همزمان با گزینه -print استفاده کرد.

       -entrytext TEXT
              مشابه -entry است، اما محتوای پیش‌فرض کادر ورودی را روی TEXT تنظیم
              می‌کند.

       -noescape
              از بسته شدن پنجره در صورت فشرده شدن کلید ESC جلوگیری می‌کند. این
              گزینه فقط در صورتی کار می‌کند که فایلی با نام
              /usr/share/gxmessage/allow_noescape وجود داشته باشد.

       -nofocus
              از فوکوس گرفتن پنجره gxmessage هنگام باز شدن جلوگیری می‌کند.

       -ontop
              تلاش می‌کند پنجره gxmessage را جلوتر از سایر پنجره‌ها نگه دارد.

       -sticky
              موجب می‌شود تا پنجره gxmessage در تمامی فضاهای کاری (workspaces)
              ظاهر شود.

       -version
              شماره نسخه و جزئیات حق نشر برنامه را نمایش داده و خارج می‌شود.

       -wrap
              موجب می‌شود که خطوط به جای فراتر رفتن از عرض پنجره، شکسته شوند.

تنظیمات پیش‌فرض GTK (GTK DEFAULTS)
       ظاهر پیش‌فرض برنامه را می‌توان با استفاده از فایل‌های منبع GTK تنظیم کرد.
       ویجت اصلی نمایش متن با نام gxmessage-textview نام‌گذاری شده است. ویجت
       کادر ورود متن با نام gxmessage-entry نام‌گذاری شده است.

            # Example: ~/.gtkrc-2.0

            style "gxmsg" {
                text[NORMAL]   = "#cc9900"
                base[NORMAL]   = "#660000"
                text[SELECTED] = "#660000"
                base[SELECTED] = "#cc9900"
                font_name      = "monospace"
            }
            widget "*.gxmessage-textview" style  "gxmsg"
            widget "*.gxmessage-entry"    style  "gxmsg"


وضعیت خروج (EXIT STATUS)
       اگر دکمه‌ای فشرده شود، برنامه مقدار اختصاص‌داده‌شده به آن دکمه را
       برمی‌گرداند. دکمه پیش‌فرض "okay" مقدار ۰ را برمی‌گرداند.

       اگر رویداد اتمام مهلت زمانی رخ دهد، برنامه مقدار ۰ را برمی‌گرداند.

       اگر خطایی رخ دهد، یا اگر پنجره بدون فشردن دکمه یا رخ دادن رویداد مهلت
       زمانی بسته شود، برنامه با کد ۱ خارج می‌شود. فشردن کلید ESC نیز موجب خروج
       برنامه با کد ۱ می‌شود.

سازگاری با XMESSAGE (COMPATIBILITY WITH XMESSAGE)
       در صورت در دسترس نبودن gxmessage، به xmessage رجوع کنید:

            #! /bin/sh
            XMESSAGE=$(which gxmessage) || XMESSAGE=xmessage
            $XMESSAGE "hello, world"


       اگر قلم‌ها را مشخص می‌کنید، بررسی کنید از کدام برنامه استفاده می‌کنید:

            font="monospace 14"
            [ "$XMESSAGE" = xmessage ] && font="fixed"
            $XMESSAGE ${font:+-fn "$font"} "hello, world"


       از گزینه‌های خط فرمان با دو خط تیره استفاده نکنید:

            $XMESSAGE "hello, world" -buttons good
            $XMESSAGE "hello, world" --buttons bad


       از گزینه‌های مختص gxmessage استفاده نکنید:

            -entry, -entrytext, -borderless, -wrap,
            -encoding, -nofocus, -noescape, -ontop,
            -sticky, -version, -h, -?


اشکالات (BUGS)
       به دلایلی، باز کردن پنجره gxmessage بدون هیچ دکمه‌ای که به عنوان پیش‌فرض
       تنظیم شده باشد موجب می‌شود GTK یک صدای "بوق" (beep) تولید کند.

       اگر اشکالات دیگری در جدیدترین نسخه gxmessage پیدا کردید، لطفاً با
       نویسنده تماس بگیرید.

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

       مدخل GNU Info برای gxmessage شامل اطلاعات و مثال‌های تفصیلی است.

نویسندگان (AUTHORS)
       Timothy Musson <trmusson@gmail.com>

حق نشر (COPYRIGHT NOTICE)
       حق نشر © 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2012, 2015 Timothy
       Richard Musson

       کپی‌برداری و توزیع این فایل، با یا بدون تغییر، به شرط حفظ این اطلاعیه حق
       نشر و این تذکر مجاز است.

                                May 25th, 2015                    GXMESSAGE(1)