نام (NAME)

xmessage - نمایش یک پیام یا پرسش در یک پنجره (مشابه /bin/echo مبتنی بر X)

خلاصه دستور (SYNOPSIS)

xmessage [ -buttons label1[:value1],label2[:value2], ... ] [ options ] -file filename
xmessage [ -buttons label1[:value1],label2[:value2], ... ] [ options ] message ...
xmessage [ -help | -version ]

توضیحات (DESCRIPTION)

برنامه xmessage پنجره‌ای حاوی پیامی از خط فرمان، یک فایل، یا ورودی استاندارد را نمایش می‌دهد. در امتداد لبه پایینی پیام، ردیفی از دکمه‌ها قرار دارد؛ کلیک‌کردن با دکمه چپ ماوس روی هر یک از این دکمه‌ها باعث خروج xmessage خواهد شد. اینکه کدام دکمه فشرده شده است، در وضعیت خروج و به‌طور اختیاری با نوشتن برچسب دکمه در خروجی استاندارد بازگردانده می‌شود.

این برنامه معمولاً توسط اسکریپت‌های شل برای نمایش اطلاعات به کاربر یا درخواست از او برای انتخاب یک گزینه استفاده می‌شود.

مگر در حالتی که اندازه‌ای مشخص شده باشد، xmessage اندازه خود را به اندازه پیام، تا یک بیشینه اندازه، تنظیم می‌کند. اگر پیام برای پنجره بیش از حد بزرگ باشد، xmessage نوارهای پیمایش (scroll bars) را نمایش خواهد داد.

گزینه‌ها (OPTIONS)

این‌ها گزینه‌های خط فرمانی هستند که xmessage علاوه بر موارد استاندارد فهرست‌شده در X(7) پشتیبانی می‌کند.

-buttons button,button,...: این گزینه باعث می‌شود xmessage به ازای هر آرگومان button که با کاما جدا شده است، یک دکمه ایجاد کند. منبع متناظر buttons است. هر button شامل یک برچسب است که به‌طور اختیاری می‌تواند با یک دو‌نقطه و یک مقدار خروج دنبال شود. این برچسب، نام ویجت دکمه Command ایجاد‌شده است و متن پیش‌فرضی خواهد بود که به کاربر نمایش داده می‌شود. از آنجا که این مقدار، نام ویجت است، می‌تواند برای تغییر هر یک از منابع مرتبط با آن دکمه استفاده شود. اگر آن دکمه انتخاب شود، مقدار خروج توسط xmessage بازگردانده خواهد شد. مقدار خروج پیش‌فرض، ۱۰۰ به‌علاوه شماره دکمه است. دکمه‌ها از چپ و با شروع از یک شماره‌گذاری می‌شوند. رشته پیش‌فرض در صورتی که هیچ گزینه -buttons داده نشود، okay:0 است.
-default label: دکمه با label مطابق را به عنوان پیش‌فرض تعیین می‌کند. اگر مشخص نشود، هیچ پیش‌فرضی وجود ندارد. منبع متناظر defaultButton است. فشردن کلید Return در هر نقطه از پنجره xmessage، دکمه پیش‌فرض را فعال می‌کند. دکمه پیش‌فرض حاشیه پهن‌تری نسبت به سایر دکمه‌ها دارد.
-file filename: فایلی که باید نمایش داده شود. منبع متناظر file است. مقدار `-' برای filename از ورودی استاندارد می‌خواند. اگر این گزینه ارائه نشود، xmessage تمام آرگومان‌های غیرگزینه‌ای را به سبک echo نمایش خواهد داد. باید یا -file یا پیامی در خط فرمان ارائه شود، اما نه هر دو.
-print: این گزینه باعث می‌شود برنامه برچسب دکمه فشرده‌شده را در خروجی استاندارد بنویسد. معادل با تنظیم منبع printValue روی TRUE. این یکی از راه‌های دریافت بازخورد درباره این است که کدام دکمه فشرده شده است.
-center: پنجره را در مرکز صفحه نمایش ظاهر می‌کند. معادل با تنظیم منبع center روی TRUE.
-nearmouse: پنجره را در نزدیکی مکان‌نمای ماوس ظاهر می‌کند. معادل با تنظیم منبع nearMouse روی TRUE.
-timeout secs: اگر کاربر هنوز روی دکمه‌ای کلیک نکرده باشد، پس از secs ثانیه با وضعیت 0 خارج می‌شود. منبع متناظر timeout است.
-help: یک پیام راهنمای استفاده چاپ کرده و خارج می‌شود.
-version: اطلاعات نسخه را چاپ کرده و خارج می‌شود.

سلسله‌مراتب ویجت‌ها (WIDGET HIERARCHY)

دانستن نام و جایگاه هر ویجت در سلسله‌مراتب هنگام تعیین منابع برای آن‌ها سودمند است. در نمودار زیر، کلاس و نام هر ویجت آورده شده است.

Xmessage (xmessage)
	Form form
		Text message
		Command (label1)
		Command (label2)
		.
		.
		.

منابع (RESOURCES)

این برنامه دارای چند منبع سطح بالای برنامه است که امکان سفارشی‌سازی‌های مختص xmessage را فراهم می‌کنند.

file: یک رشته (String) که فایل نمایشی را مشخص می‌کند.
buttons: یک رشته (String) که دکمه‌های نمایشی را مشخص می‌کند. گزینه خط فرمان -buttons را ببینید.
defaultButton: یک رشته (String) که دکمه پیش‌فرض را با برچسب مشخص می‌کند.
printValue: یک مقدار بولی (Boolean) که مشخص می‌کند آیا برچسب دکمه فشرده‌شده برای خروج از برنامه در خروجی استاندارد نوشته شود یا خیر. پیش‌فرض FALSE است.
center: یک مقدار بولی (Boolean) که مشخص می‌کند آیا پنجره در مرکز صفحه نمایش ظاهر شود یا خیر. پیش‌فرض FALSE است.
nearMouse: یک مقدار بولی (Boolean) که مشخص می‌کند آیا پنجره در نزدیکی مکان‌نمای ماوس ظاهر شود یا خیر. پیش‌فرض FALSE است.
timeout: تعداد ثانیه‌هایی که پس از آن برنامه با وضعیت 0 خارج می‌شود. پیش‌فرض 0 است، به این معنی که هرگز زمان‌بندی سر نمی‌رسد.
maxHeight (class Maximum): بیشینه ارتفاع بخش متنی پنجره بر حسب پیکسل، که در صورت تعیین نشدن اندازه در هندسه (geometry) استفاده می‌شود. پیش‌فرض 0 است، به این معنی که از ۷۰٪ ارتفاع صفحه نمایش استفاده شود.
maxWidth (class Maximum): بیشینه پهنای بخش متنی پنجره بر حسب پیکسل، که در صورت تعیین نشدن اندازه در هندسه (geometry) استفاده می‌شود. پیش‌فرض 0 است، به این معنی که از ۷۰٪ پهنای صفحه نمایش استفاده شود.

کنش‌ها (ACTIONS)

exit(value): خروج فوری با وضعیت خروج value (پیش‌فرض 0). این کنش می‌تواند با translations استفاده شود تا راه‌های جایگزینی برای خروج از xmessage فراهم کند.
default-exit(): خروج فوری با وضعیت خروج مشخص‌شده توسط دکمه پیش‌فرض. اگر هیچ دکمه پیش‌فرضی وجود نداشته باشد، این کنش اثری ندارد.

وضعیت خروج (EXIT STATUS)

اگر xmessage خطایی را شناسایی کند، مقدار 1 را برمی‌گرداند، بنابراین این مقدار نباید برای یک دکمه استفاده شود.

همچنین ببینید (SEE ALSO)

X(7), echo(1), cat(1)

نویسندگان (AUTHORS)

Chris Peterson, MIT Project Athena
Stephen Gildea, X Consortium