نام (NAME)

xcutsel - تبادل داده میان cut buffer و گزینش (selection)

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

xcutsel [-toolkitoption ...] [-selection selection] [-cutbuffer number]

xcutsel -help | -version

توضیحات (DESCRIPTION)

برنامهٔ xcutsel برای رونویسی گزینش (selection) فعلی در یک cut buffer و ایجاد یک گزینش شامل محتویات فعلی cut buffer به کار می‌رود. این برنامه به عنوان پلی میان برنامه‌هایی که از گزینش‌ها پشتیبانی نمی‌کنند و برنامه‌هایی که پشتیبانی می‌کنند عمل می‌کند.

به‌طور پیش‌فرض، xcutsel از گزینشی با نام PRIMARY و cut buffer با نام CUT_BUFFER0 استفاده می‌کند. هر یک از این دو مورد یا هر دوی آن‌ها را می‌توان با آرگومان‌های خط فرمان یا از طریق منابع (resources) جایگزین کرد.

پنجرهٔ xcutsel شامل دکمه‌های زیر است:

quit: با فشردن این دکمه، xcutsel خارج می‌شود. هر گزینشی که در اختیار xcutsel باشد به‌طور خودکار آزاد می‌شود.
copy PRIMARY to 0: با فشردن این دکمه، xcutsel گزینش فعلی را درون cut buffer رونویسی می‌کند.
copy 0 to PRIMARY: با فشردن این دکمه، xcutsel محتویات فعلی cut buffer را به گزینش تبدیل می‌کند.

برچسب دکمه‌ها بازتاب‌دهندهٔ گزینش و cutbuffer تعیین‌شده از طریق گزینه‌های خط فرمان یا پایگاه‌دادهٔ منابع هستند.

هنگامی که دکمهٔ “copy 0 to PRIMARY” فعال شود، تا زمانی که xcutsel مالک گزینش باقی بماند، دکمه به صورت معکوس‌شده باقی خواهد ماند. این حالت برای یادآوری این نکته است که کدام کلاینت مالک گزینش فعلی است. توجه داشته باشید که مقدار گزینش ثابت می‌ماند؛ اگر cutbuffer تغییر کند، برای دریافت مقدار جدید در صورت نیاز باید دوباره دکمهٔ copy را فعال کنید.

گزینه‌ها (OPTIONS)

برنامهٔ .I Xcutsel تمام گزینه‌های خط فرمان استاندارد X Toolkit و همچنین موارد زیر را می‌پذیرد:

-selection name: این گزینه نام گزینش مورد استفاده را مشخص می‌کند. مقدار پیش‌فرض PRIMARY است. تنها مخفف‌های پشتیبانی‌شده برای این گزینه “-select”، “-sel” و “-s” هستند، زیرا گزینهٔ استاندارد جعبه‌ابزار “-selectionTimeout” نامی مشابه دارد.
-cutbuffer number: این گزینه cut buffer مورد استفاده را مشخص می‌کند. پیش‌فرض، cut buffer شمارهٔ 0 است.
-help: پیام راهنمای استفاده را چاپ کرده و خارج می‌شود.
-version: اطلاعات نگارش را چاپ کرده و خارج می‌شود.

پیش‌فرض‌های X (X DEFAULTS)

این برنامه تمام نام‌ها و کلاس‌های منابع استاندارد X Toolkit و همچنین موارد زیر را می‌پذیرد:

selection (class Selection): این منبع نام گزینش مورد استفاده را مشخص می‌کند. مقدار پیش‌فرض PRIMARY است.
cutBuffer (class CutBuffer): این منبع شمارهٔ cut buffer مورد استفاده را مشخص می‌کند. مقدار پیش‌فرض 0 است.

نام‌های ویجت (WIDGET NAMES)

در صورتی که پیکربندی برچسب‌های ویجت‌ها توسط کاربر مد نظر باشد، می‌توان از نام‌های نمونهٔ (instance names) زیر استفاده کرد:

sel-cut (class Command): این دکمهٔ “copy SELECTION to BUFFER” است.
cut-sel (class Command): این دکمهٔ “copy BUFFER to SELECTION” است.
quit (class Command): این دکمهٔ “quit” است.

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

xclipboard(1), X(7), مستندات ویجت متن (text widget)، مستندات اختصاصی هر کلاینت برای نحوهٔ ایجاد یک گزینش.

گزارش باگ‌ها (BUGS)

هیچ روشی برای تغییر نام گزینش یا شمارهٔ cut buffer در حین اجرای برنامه وجود ندارد.

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

Ralph R. Swick، پروژهٔ DEC/MIT Athena