نام (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)

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