.TH "GXMESSAGE" "1" "May 25th, 2015" "" ""
.\"
.\"
.\"
.de EX        \" begin example
.ne 5
.if n .sp 1
.if t .sp .5
.nf
.in +.5i
..
.de EE        \" end example
.fi
.in -.5i
.if n .sp 1
.if t .sp .5
..
.\"
.\"
.\"
.SH "نام (NAME)"
gxmessage \- باز کردن کادرهای گفتگوی گرافیکی مبتنی بر GTK
.\"
.\"
.\"
.SH "خلاصه دستور (SYNOPSIS)"
\fBgxmessage\fR [\fIگزینه‌ها\fR] \fBپیام\fR ...
.br
\fBgxmessage\fR [\fIگزینه‌ها\fR] -file \fIنام_فایل\fR
.\"
.\"
.\"
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBgxmessage\fR
پنجره‌ای را برای نمایش پیامی که از خط فرمان، از یک فایل یا از ورودی استاندارد (\fIstdin\fR) دریافت شده باز می‌کند. این پنجره شامل ردیفی از دکمه‌ها است که هر یک از آن‌ها موجب خروج برنامه با یک کد بازگشتی متفاوت می‌شود.
.PP
مدخل GNU Info برای gxmessage شامل اطلاعات و مثال‌های تفصیلی است.
.\"
.\"
.\"
.SH "گزینه‌ها (OPTIONS)"
.PP
دستور
\fBgxmessage\fR
هر گزینه‌ای را که
\fBxmessage\fR
بپذیرد قبول می‌کند؛ هرچند برخی گزینه‌ها (مانند
\fB-bw\fR
و
\fB-xrm\fR)
بدون هشدار نادیده گرفته می‌شوند.
.TP
\fB-bg\fR \fICOLOR\fR
.br
رنگ پس‌زمینه پیام را روی
\fICOLOR\fR
تنظیم می‌کند. مثال‌ها: red،‏ "#c90"،‏ "#446a7e".
.TP
\fB-buttons\fR \fIBUTTON_LIST\fR
.br
دکمه‌هایی که باید ساخته شوند را تعریف می‌کند.
\fIBUTTON_LIST\fR
فهرستی از جفت‌های
\fILABEL\fR\fB:\fR\fIVALUE\fR
جداشده با کاما برای هر دکمه است.
\fILABEL\fR
متنی است که روی دکمه نمایش داده می‌شود.
\fIVALUE\fR
(بین ۰ تا ۲۵۵) کدی است که برنامه در صورت فشرده شدن آن دکمه با آن خارج می‌شود. کاما و دونقطه را می‌توان با استفاده از بک‌اسلش (\\) اسکیپ کرد. علاوه بر متن عادی،
\fILABEL\fR
می‌تواند یک دکمه پیش‌ساخته (stock) در GTK مانند "GTK_STOCK_CANCEL" را مشخص کند، یا می‌تواند شامل یک خط زیرین (_) برای تعیین کلید میانبر صفحه‌کلید باشد. در صورت حذف
\fIVALUE\fRها،
آن‌ها به ترتیب روی ۱۰۱، ۱۰۲، ۱۰۳ و غیره پیش‌فرض می‌شوند. اگر گزینه
\fB-buttons\fR
داده نشود،
\fIBUTTON_LIST\fR
به طور پیش‌فرض برابر با
\fB"okay:0"\fR
خواهد بود.
.EX
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"
.EE
.TP
\fB-center\fR
.br
پنجره
\fBgxmessage\fR
را در وسط صفحه نمایش باز می‌کند.
.TP
\fB-default\fR \fILABEL\fR
.br
پنجره
\fBgxmessage\fR
را با تمرکز ورودی روی دکمه مشخص‌شده باز می‌کند.
\fILABEL\fR
یکی از برچسب‌های موجود در
\fIBUTTON_LIST\fR
است (گزینه
\fB-buttons\fR
در بالا را ببینید).
.TP
\fB-display\fR \fIDISPLAY\fR
.br
نمایشگر X مورد استفاده را مشخص می‌کند.
.TP
\fB-fg\fR \fICOLOR\fR
.br
رنگ متن پیام را روی
\fICOLOR\fR
تنظیم می‌کند.
.TP
\fB-file\fR \fIFILENAME\fR
.br
موجب می‌شود تا فایل نام‌برده‌شده به عنوان منبع پیام استفاده شود. اگر خط تیره (-) به جای
\fIFILENAME\fR
به کار رود، پیام از ورودی استاندارد (\fIstdin\fR) خوانده می‌شود.
.TP
\fB-fn\fR | \fB-font\fR \fIFONT\fR
.br
قلم پیام را با استفاده از سیستم تعیین قلم GTK مشخص می‌کند؛ برای نمونه،
\fB-font "serif italic 14"\fR.
(سیستم قلم GTK با
\fBxmessage\fR
سازگار نیست. بخش سازگاری در ادامه را برای راهکار جایگزین ببینید.)
.TP
\fB-geometry\fR \fIGEOMETRY\fR
.br
اندازه یا موقعیت پنجره را تنظیم می‌کند. مثال‌ها:
.EX
-geometry 400x200
-geometry 400x200+600+100
-geometry +600+100
.EE
.TP
\fB-help\fR
.br
اطلاعات پایه نحوه استفاده را نمایش داده و خارج می‌شود.
.TP
\fB-iconic\fR
.br
پنجره
\fBgxmessage\fR
را در حالت کمینه‌شده (آیکون) باز می‌کند.
.TP
\fB-name\fR \fINAME\fR
.br
نام پنجره
\fBgxmessage\fR
را روی
\fINAME\fR
تنظیم می‌کند.
.TP
\fB-nearmouse\fR
.br
پنجره
\fBgxmessage\fR
را در نزدیکی نشانگر موش باز می‌کند.
.TP
\fB-print\fR
.br
مقدار
\fILABEL\fR
دکمه انتخاب‌شده را در خروجی استاندارد (\fIstdout\fR) می‌نویسد.
.TP
\fB-timeout\fR \fISECONDS\fR
.br
اگر هیچ دکمه‌ای در طول
\fISECONDS\fR
ثانیه فشرده نشود، پنجره
\fBgxmessage\fR
را به طور خودکار با کد خروج ۰ می‌بندد. (گزینه‌های
\fB-entry\fR
و
\fB-entrytext\fR
موجب نادیده گرفته شدن
\fB-timeout\fR
می‌شوند.)
.TP
\fB-title\fR \fITITLE\fR
.br
عنوان پنجره
\fBgxmessage\fR
را روی
\fITITLE\fR
تنظیم می‌کند.
.\"
.\"
.\"
.SH "گزینه‌های ویژه GXMESSAGE (GXMESSAGE SPECIFIC OPTIONS)"
.PP
گزینه‌های زیر مختص
\fBgxmessage\fR
هستند و با
\fBxmessage\fR
سازگاری ندارند.
.TP
\fB-borderless\fR
.br
پنجره
\fBgxmessage\fR
را بدون قاب معمول پنجره باز می‌کند.
.TP
\fB-encoding\fR \fICHARSET\fR
.br
کدگذاری نویسه‌های متن پیام را مشخص می‌کند. به طور پیش‌فرض، فرض می‌شود که متن پیام با کدگذاری محلی جاری (locale) مطابقت دارد.
.TP
\fB-entry\fR
.br
یک کادر ورود متن به پنجره
\fBgxmessage\fR
اضافه می‌کند. هنگام بسته شدن پنجره، هر متنی در کادر ورود متن در خروجی استاندارد (\fIstdout\fR) کپی می‌شود. این گزینه را نمی‌توان همزمان با گزینه
\fB-print\fR
استفاده کرد.
.TP
\fB-entrytext\fR \fITEXT\fR
.br
مشابه
\fB-entry\fR
است، اما محتوای پیش‌فرض کادر ورودی را روی
\fITEXT\fR
تنظیم می‌کند.
.TP
\fB-noescape\fR
.br
از بسته شدن پنجره در صورت فشرده شدن کلید ESC جلوگیری می‌کند. این گزینه فقط در صورتی کار می‌کند که فایلی با نام /usr/share/gxmessage/allow_noescape وجود داشته باشد.
.TP
\fB-nofocus\fR
.br
از فوکوس گرفتن پنجره
\fBgxmessage\fR
هنگام باز شدن جلوگیری می‌کند.
.TP
\fB-ontop\fR
.br
تلاش می‌کند پنجره
\fBgxmessage\fR
را جلوتر از سایر پنجره‌ها نگه دارد.
.TP
\fB-sticky\fR
.br
موجب می‌شود تا پنجره
\fBgxmessage\fR
در تمامی فضاهای کاری (workspaces) ظاهر شود.
.TP
\fB-version\fR
.br
شماره نسخه و جزئیات حق نشر برنامه را نمایش داده و خارج می‌شود.
.TP
\fB-wrap\fR
.br
موجب می‌شود که خطوط به جای فراتر رفتن از عرض پنجره، شکسته شوند.
.\"
.\"
.\"
.SH "تنظیمات پیش‌فرض GTK (GTK DEFAULTS)"
.PP
ظاهر پیش‌فرض برنامه را می‌توان با استفاده از فایل‌های منبع GTK تنظیم کرد. ویجت اصلی نمایش متن با نام
\fBgxmessage-textview\fR
نام‌گذاری شده است. ویجت کادر ورود متن با نام
\fBgxmessage-entry\fR
نام‌گذاری شده است.
.EX
# 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"
.EE
.\"
.\"
.\"
.SH "وضعیت خروج (EXIT STATUS)"
.PP
اگر دکمه‌ای فشرده شود، برنامه مقدار اختصاص‌داده‌شده به آن دکمه را برمی‌گرداند. دکمه پیش‌فرض "okay" مقدار ۰ را برمی‌گرداند.
.PP
اگر رویداد اتمام مهلت زمانی رخ دهد، برنامه مقدار ۰ را برمی‌گرداند.
.PP
اگر خطایی رخ دهد، یا اگر پنجره بدون فشردن دکمه یا رخ دادن رویداد مهلت زمانی بسته شود، برنامه با کد ۱ خارج می‌شود. فشردن کلید ESC نیز موجب خروج برنامه با کد ۱ می‌شود.
.\"
.\"
.\"
.SH "سازگاری با XMESSAGE (COMPATIBILITY WITH XMESSAGE)"
.PP
در صورت در دسترس نبودن
\fBgxmessage\fR،
به
\fBxmessage\fR
رجوع کنید:
.EX
#! /bin/sh
XMESSAGE=$(which gxmessage) || XMESSAGE=xmessage
$XMESSAGE "hello, world"
.EE
.PP
اگر قلم‌ها را مشخص می‌کنید، بررسی کنید از کدام برنامه استفاده می‌کنید:
.EX
font="monospace 14"
[ "$XMESSAGE" = xmessage ] && font="fixed"
$XMESSAGE ${font:+-fn "$font"} "hello, world"
.EE
.PP
از گزینه‌های خط فرمان با دو خط تیره استفاده نکنید:
.EX
$XMESSAGE "hello, world" -buttons good
$XMESSAGE "hello, world" \-\-buttons bad
.EE
.PP
از گزینه‌های مختص
\fBgxmessage\fR
استفاده نکنید:
.EX
\fB-entry\fR, \fB-entrytext\fR, \fB-borderless\fR, \fB-wrap\fR,
\fB-encoding\fR, \fB-nofocus\fR, \fB-noescape\fR, \fB-ontop\fR,
\fB-sticky\fR, \fB-version\fR, \fB-h\fR, \fB-?\fR
.EE
.\"
.\"
.\"
.SH "اشکالات (BUGS)"
.PP
به دلایلی، باز کردن پنجره gxmessage بدون هیچ دکمه‌ای که به عنوان پیش‌فرض تنظیم شده باشد موجب می‌شود GTK یک صدای "بوق" (beep) تولید کند.
.PP
اگر اشکالات دیگری در جدیدترین نسخه
\fBgxmessage\fR
پیدا کردید، لطفاً با نویسنده تماس بگیرید.
.\"
.\"
.\"
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fIxmessage\fR(1), \fIzenity\fR(1), \fIdialog\fR(1)
.PP
مدخل GNU Info برای gxmessage شامل اطلاعات و مثال‌های تفصیلی است.
.\"
.\"
.\"
.SH "نویسندگان (AUTHORS)"
.PP
Timothy Musson <trmusson@gmail.com>
.\"
.\"
.\"
.SH "حق نشر (COPYRIGHT NOTICE)"
حق نشر \(co 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2012, 2015 Timothy Richard Musson
.PP
کپی‌برداری و توزیع این فایل، با یا بدون تغییر، به شرط حفظ این اطلاعیه حق نشر و این تذکر مجاز است.