.\" $XConsortium: xmessage.man,v 1.8 95/03/08 22:28:48 gildea Exp $
.\"
.\" $XFree86$
.\"
.TH XMESSAGE 1 "xmessage 1.0.7" "X Version 11"
.SH "نام (NAME)"
xmessage \- نمایش یک پیام یا پرسش در یک پنجره (مشابه /bin/echo مبتنی بر X)
.SH "خلاصه دستور (SYNOPSIS)"
.B xmessage
[
.B \-buttons
.I label1\fR[\fP\fB:\fPvalue1\fR]\fP\fB,\fPlabel2\fR[\fP\fB:\fPvalue2\fR]\fP\fB,\fP
\&\|.\|.\|.
] [
.I options
]
.B \-file
.I filename
.br
.B xmessage
[
.B \-buttons
.I label1\fR[\fP\fB:\fPvalue1\fR]\fP\fB,\fPlabel2\fR[\fP\fB:\fPvalue2\fR]\fP\fB,\fP
\&\|.\|.\|.
] [
.I options
]
.I message
\&.\|.\|.
.br
.B xmessage
[
.B \-help
|
.B \-version
]
.SH "توضیحات (DESCRIPTION)"
برنامه
.I xmessage
پنجره‌ای حاوی پیامی از خط فرمان، یک فایل، یا ورودی استاندارد را نمایش می‌دهد.
در امتداد لبه پایینی پیام، ردیفی از دکمه‌ها قرار دارد؛ کلیک‌کردن با دکمه چپ ماوس روی هر یک از این دکمه‌ها باعث خروج \fIxmessage\fP خواهد شد.
اینکه کدام دکمه فشرده شده است، در وضعیت خروج و به‌طور اختیاری با نوشتن برچسب دکمه در خروجی استاندارد بازگردانده می‌شود.
.PP
این برنامه معمولاً توسط اسکریپت‌های شل برای نمایش اطلاعات به کاربر یا درخواست از او برای انتخاب یک گزینه استفاده می‌شود.
.PP
مگر در حالتی که اندازه‌ای مشخص شده باشد، \fIxmessage\fP اندازه خود را به اندازه پیام، تا یک بیشینه اندازه، تنظیم می‌کند.
اگر پیام برای پنجره بیش از حد بزرگ باشد، \fIxmessage\fP نوارهای پیمایش (scroll bars) را نمایش خواهد داد.
.SH "گزینه‌ها (OPTIONS)"
این‌ها گزینه‌های خط فرمانی هستند که \fIxmessage\fP علاوه بر موارد استاندارد فهرست‌شده در
.BR X (7)
پشتیبانی می‌کند.
.TP 8
.B \-buttons \fIbutton,button,.\|.\|.\fP
این گزینه باعث می‌شود \fIxmessage\fP به ازای هر آرگومان \fIbutton\fP که با کاما جدا شده است، یک دکمه ایجاد کند.
منبع متناظر \fBbuttons\fP است.
هر \fIbutton\fP شامل یک برچسب است که به‌طور اختیاری می‌تواند با یک دو‌نقطه و یک مقدار خروج دنبال شود.
این برچسب، نام ویجت دکمه Command ایجاد‌شده است و متن پیش‌فرضی خواهد بود که به کاربر نمایش داده می‌شود. از آنجا که این مقدار، نام ویجت است، می‌تواند برای تغییر هر یک از منابع مرتبط با آن دکمه استفاده شود.
اگر آن دکمه انتخاب شود، مقدار خروج توسط \fIxmessage\fP بازگردانده خواهد شد. مقدار خروج پیش‌فرض، ۱۰۰ به‌علاوه شماره دکمه است. دکمه‌ها از چپ و با شروع از یک شماره‌گذاری می‌شوند.
رشته پیش‌فرض در صورتی که هیچ گزینه \fB\-buttons\fP داده نشود، \fBokay:0\fP است.
.TP 8
.B \-default \fIlabel\fP
دکمه با \fIlabel\fP مطابق را به عنوان پیش‌فرض تعیین می‌کند.
اگر مشخص نشود، هیچ پیش‌فرضی وجود ندارد.
منبع متناظر \fBdefaultButton\fP است.
فشردن کلید Return در هر نقطه از پنجره \fIxmessage\fP، دکمه پیش‌فرض را فعال می‌کند.
دکمه پیش‌فرض حاشیه پهن‌تری نسبت به سایر دکمه‌ها دارد.
.TP 8
.B \-file \fIfilename\fP
فایلی که باید نمایش داده شود.
منبع متناظر \fBfile\fP است.
مقدار `\fB\-\fP' برای \fIfilename\fP از ورودی استاندارد می‌خواند.
اگر این گزینه ارائه نشود، \fIxmessage\fP تمام آرگومان‌های غیرگزینه‌ای را به سبک \fIecho\fP نمایش خواهد داد.
باید یا \fB\-file\fP یا پیامی در خط فرمان ارائه شود، اما نه هر دو.
.TP 8
.B \-print
این گزینه باعث می‌شود برنامه برچسب دکمه فشرده‌شده را در خروجی استاندارد بنویسد. معادل با تنظیم منبع \fBprintValue\fP روی TRUE.
این یکی از راه‌های دریافت بازخورد درباره این است که کدام دکمه فشرده شده است.
.TP 8
.B \-center
پنجره را در مرکز صفحه نمایش ظاهر می‌کند.
معادل با تنظیم منبع \fBcenter\fP روی TRUE.
.TP 8
.B \-nearmouse
پنجره را در نزدیکی مکان‌نمای ماوس ظاهر می‌کند.
معادل با تنظیم منبع \fBnearMouse\fP روی TRUE.
.TP 8
.B \-timeout \fIsecs\fP
اگر کاربر هنوز روی دکمه‌ای کلیک نکرده باشد، پس از \fIsecs\fP ثانیه با وضعیت 0 خارج می‌شود.
منبع متناظر \fBtimeout\fP است.
.TP 8
.B \-help
یک پیام راهنمای استفاده چاپ کرده و خارج می‌شود.
.TP 8
.B \-version
اطلاعات نسخه را چاپ کرده و خارج می‌شود.
.SH "سلسله‌مراتب ویجت‌ها (WIDGET HIERARCHY)"
دانستن نام و جایگاه هر ویجت در سلسله‌مراتب هنگام تعیین منابع برای آن‌ها سودمند است. در نمودار زیر، کلاس و نام هر ویجت آورده شده است.
.LP
.nf
Xmessage (xmessage)
	Form form
		Text message
		Command (label1)
		Command (label2)
		.
		.
		.
.fi
.SH "منابع (RESOURCES)"
این برنامه دارای چند منبع سطح بالای برنامه است که امکان سفارشی‌سازی‌های مختص \fIxmessage\fP را فراهم می‌کنند.
.TP 8
.B file
یک رشته (String) که فایل نمایشی را مشخص می‌کند.
.TP 8
.B buttons
یک رشته (String) که دکمه‌های نمایشی را مشخص می‌کند.
گزینه خط فرمان \fB\-buttons\fP را ببینید.
.TP 8
.B defaultButton
یک رشته (String) که دکمه پیش‌فرض را با برچسب مشخص می‌کند.
.TP 8
.B printValue
یک مقدار بولی (Boolean) که مشخص می‌کند آیا برچسب دکمه فشرده‌شده برای خروج از برنامه در خروجی استاندارد نوشته شود یا خیر.
پیش‌فرض FALSE است.
.TP 8
.B center
یک مقدار بولی (Boolean) که مشخص می‌کند آیا پنجره در مرکز صفحه نمایش ظاهر شود یا خیر. پیش‌فرض FALSE است.
.TP 8
.B nearMouse
یک مقدار بولی (Boolean) که مشخص می‌کند آیا پنجره در نزدیکی مکان‌نمای ماوس ظاهر شود یا خیر. پیش‌فرض FALSE است.
.TP 8
.B timeout
تعداد ثانیه‌هایی که پس از آن برنامه با وضعیت 0 خارج می‌شود. پیش‌فرض 0 است، به این معنی که هرگز زمان‌بندی سر نمی‌رسد.
.TP 8
.B "maxHeight (\fPclass\fB Maximum)
بیشینه ارتفاع بخش متنی پنجره بر حسب پیکسل، که در صورت تعیین نشدن اندازه در هندسه (geometry) استفاده می‌شود.
پیش‌فرض 0 است، به این معنی که از ۷۰٪ ارتفاع صفحه نمایش استفاده شود.
.TP 8
.B "maxWidth (\fPclass\fB Maximum)
بیشینه پهنای بخش متنی پنجره بر حسب پیکسل، که در صورت تعیین نشدن اندازه در هندسه (geometry) استفاده می‌شود.
پیش‌فرض 0 است، به این معنی که از ۷۰٪ پهنای صفحه نمایش استفاده شود.
.SH "کنش‌ها (ACTIONS)"
.TP 8
.B exit(\fIvalue\fP)
خروج فوری با وضعیت خروج \fIvalue\fP (پیش‌فرض 0). این کنش می‌تواند با translations استفاده شود تا راه‌های جایگزینی برای خروج از \fIxmessage\fP فراهم کند.
.TP 8
.B default-exit()
خروج فوری با وضعیت خروج مشخص‌شده توسط دکمه پیش‌فرض.
اگر هیچ دکمه پیش‌فرضی وجود نداشته باشد، این کنش اثری ندارد.
.SH "وضعیت خروج (EXIT STATUS)"
اگر \fIxmessage\fP خطایی را شناسایی کند، مقدار 1 را برمی‌گرداند، بنابراین این مقدار نباید برای یک دکمه استفاده شود.
.SH "همچنین ببینید (SEE ALSO)"
.IR X (7),
.IR echo (1),
.IR cat (1)
.br
.SH "نویسندگان (AUTHORS)"
Chris Peterson, MIT Project Athena
.br
Stephen Gildea, X Consortium