.TH XEV 1 2025-03-24 "xev 1.2.7" "X Version 11"
.SH "نام (NAME)"
xev \- چاپ محتوای رویدادهای X
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBxev\fP [\fB\-display\fP \fIdisplayname\fP] [\fB\-geometry\fP \fIgeom\fP] [\fB\-bw\fP \fIpixels\fP]
    [\fB\-bs\fP \fBNotUseful\fP|\fBWhenMapped\fP|\fBAlways\fP] [\fB\-id\fP \fIwindowid\fP] [\fB\-root\fP] [\fB\-s\fP]
    [\fB\-name\fP \fIstring\fP] [\fB\-rv\fP] [\fB\-event\fP \fIevent_mask\fP [\fB\-event\fP \fIevent_mask\fP ...]]
    [\fB\-help\fP|\fB\-version\fP]
.fi
.SH "توضیحات (DESCRIPTION)"
برنامهٔ \fBxev\fP یک پنجره ایجاد کرده و سپس از کارساز X درخواست می‌کند هر زمان که اتفاقی برای پنجره رخ داد (مانند جابه‌جا شدن، تغییر اندازه، تایپ در آن، کلیک روی آن و غیره)،
\fIرویدادها\fP را برای آن ارسال کند. همچنین می‌توانید آن را به یک پنجرهٔ از قبل موجود متصل کنید. این ابزار برای مشاهدهٔ عوامل رخ دادن رویدادها و نمایش اطلاعات محتوای آن‌ها سودمند است؛
\fBxev\fP اساساً یک ابزار اشکال‌زدایی و توسعه است و در استفاده‌های معمول نیازی به آن نخواهد بود.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B \-display \fIdisplay\fP
این گزینه کارساز X را جهت برقراری ارتباط مشخص می‌کند.
.TP 8
.B \-geometry \fIgeom\fP
این گزینه در صورت نیاز به ایجاد پنجره، اندازه و/یا مکان پنجره را مشخص می‌کند.
.TP 8
.B \-bw \fIpixels\fP
این گزینه عرض حاشیهٔ پنجره را بر حسب پیکسل مشخص می‌کند.
.TP 8
.B \-bs \fBNotUseful\fP|\fBWhenMapped\fP|\fBAlways\fP
این گزینه نوع backing store اختصاص‌یافته به پنجره را مشخص می‌کند.
پیش‌فرض \fBNotUseful\fP است. عبارت backing store به پیکسل‌های ذخیره‌شده در خارج از صفحه اشاره دارد، زمانی که کارساز X محتویات یک پنجره را نگهداری می‌کند؛ \fBNotUseful\fP بدان معناست که در صورت نیاز، خود فرایند xev محتویاتش را دوباره ترسیم خواهد کرد.
.TP 8
.B \-id \fIwindowid\fP
این گزینه مشخص می‌کند که به جای ایجاد یک پنجرهٔ جدید، پنجره با شناسهٔ مشخص‌شده پایش شود.
.TP 8
.B \-root
این گزینه مشخص می‌کند که به جای ایجاد یک پنجرهٔ جدید، پنجرهٔ ریشه (root window) پایش شود.
.TP 8
.B \-s
این گزینه مشخص می‌کند که ویژگی save-unders روی پنجره فعال شود. مفهوم save-unders مشابه backing store است، اما بیشتر به ذخیرهٔ پیکسل‌ها در خارج از صفحه زمانی اشاره دارد که پنجرهٔ فعلی روی پنجره‌های دیگر قرار گرفته و آن‌ها را می‌پوشاند. ویژگی save-unders صرفاً جنبهٔ توصیه‌ای دارد و معمولاً برای کادرهای محاوره‌ای بازشو (popup) و دیگر پنجره‌های گذرا تنظیم می‌شود.
.TP 8
.B \-name \fIstring\fP
این گزینه نام اختصاص‌یافته به پنجرهٔ ایجادشده را مشخص می‌کند.
.TP 8
.B \-rv
این گزینه مشخص می‌کند که پنجره در حالت ویدئوی معکوس (reverse video) نمایش داده شود.
.TP 8
.B \-event \fIevent_mask\fP
انتخاب رویدادهایی که باید نمایش داده شوند.
گزینهٔ
.B \-event
را می‌توان چندین بار برای انتخاب چندین نوع رویداد مختلف مشخص کرد.
در صورت مشخص نشدن، تمام رویدادها انتخاب می‌شوند.
ماسک‌های رویداد در دسترس:
\fBkeyboard mouse expose visibility structure substructure
focus property colormap owner_grab_button randr button\fP
.TP 8
.B \-help
این گزینه راهنمای استفاده از برنامه را چاپ کرده و خارج می‌شود.
.TP 8
.B \-version
این گزینه نسخهٔ برنامه را چاپ کرده و خارج می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7),
.BR xwininfo (1),
.BR xdpyinfo (1),
.IR "Xlib Programmers Manual" ,
.I "X Protocol Specification"
.SH "نویسندگان (AUTHORS)"
Jim Fulton, MIT X Consortium