| XCLIPBOARD(1) | X Version 11 | XCLIPBOARD(1) |
نام (NAME)
xclipboard - کلاینت کلیپ‌بورد برای سامانهٔ پنجره‌ای X
خلاصه دستور (SYNOPSIS)
xclipboard [ -toolkitoption ... ] [ -w ] [ -nw ]
xclipboard -help | -version
توضیحات (DESCRIPTION)
برنامهٔ xclipboard برای جمع‌آوری و نمایش گزینش‌های متنی (text selections) که توسط سایر کلاینت‌ها به CLIPBOARD فرستاده می‌شوند، به کار می‌رود. این برنامه معمولاً برای ذخیره کردن گزینش‌های CLIPBOARD جهت استفاده‌های بعدی کاربرد دارد. برنامه هر گزینش CLIPBOARD را به صورت یک رشتهٔ مجزا ذخیره می‌کند که هر کدام از آن‌ها قابل انتخاب هستند. هر بار که CLIPBOARD توسط برنامهٔ دیگری ادعا (assert) شود، xclipboard محتویات آن گزینش را به یک بافر جدید منتقل کرده و آن را در پنجرهٔ متنی نمایش می‌دهد. بافرها هیچ‌گاه به صورت خودکار حذف نمی‌شوند، بنابراین برای رهایی از موارد بلااستفاده باید از دکمهٔ delete استفاده کنید.
از آنجا که xclipboard برای نمایش محتویات کلیپ‌بورد از یک ویجت متنی (Text Widget) استفاده می‌کند، متنی که به CLIPBOARD ارسال شده است را می‌توان مجدداً برای استفاده در برنامه‌های دیگر گزینش کرد. xclipboard همچنین به درخواست‌های دریافت گزینش CLIPBOARD از سوی دیگر کلاینت‌ها، با ارسال تمام محتویات بافری که در حال حاضر نمایش داده می‌شود، پاسخ می‌دهد.
پنجرهٔ xclipboard دکمه‌های زیر را در امتداد لبهٔ بالایی خود دارد:
- quit
- با فشردن این دکمه، xclipboard خارج می‌شود.
- delete
- با فشردن این دکمه، بافر فعلی حذف شده و بافر بعدی نمایش داده می‌شود.
- new
- یک بافر جدید بدون محتوا ایجاد می‌کند. برای ایجاد دستی یک گزینشِ جدیدِ CLIPBOARD مفید است.
- save
- یک کادر محاوره‌ای ذخیرهٔ فایل (File Save) را نمایش می‌دهد. فشردن دکمهٔ Accept بافر در حال نمایش را در فایلی که در فیلد متنی مشخص شده، ذخیره می‌کند.
- next
- بافر بعدی در فهرست را نمایش می‌دهد.
- previous
- بافر قبلی را نمایش می‌دهد.
گزینه‌ها (OPTIONS)
برنامهٔ xclipboard تمامی گزینه‌های خط فرمان استاندارد X Toolkit و همچنین موارد زیر را می‌پذیرد:
- -w
- این گزینه مشخص می‌کند خطوط متنی که بیش از حد برای نمایش در یک خط کلیپ‌بورد طولانی هستند، باید شکسته شده و به خطوط بعدی منتقل شوند (wrap).
- -nw
- این گزینه مشخص می‌کند خطوط طولانی متن نباید شکسته شوند. این رفتار پیش‌فرض است.
- -help
- پیام راهنمای نحوهٔ استفاده را چاپ کرده و خارج می‌شود.
- -version
- اطلاعات نسخه را چاپ کرده و خارج می‌شود.
ویجت‌ها (WIDGETS)
به منظور مشخص کردن منابع (resources)، دانستن سلسله‌مراتب ویجت‌هایی که xclipboard را تشکیل می‌دهند مفید است. در ساختار زیر، تورفتگی نشان‌دهندهٔ ساختار سلسله‌مراتبی است. ابتدا نام کلاس ویجت و سپس نام نمونهٔ (instance) ویجت ذکر شده است.
XClipboard xclipboard Form form Command Quit Command delete Command new Command Save Command next Command prev Label index Text text TransientShell fileDialogShell Dialog fileDialog Label label Command accept Command cancel Text value TransientShell failDialogShell Dialog failDialog Label label Command continue
ارسال/دریافت محتویات کلیپ‌بورد (SENDING/RETRIEVING CLIPBOARD CONTENTS)
هر زمان که یک کلاینت مالکیت گزینش CLIPBOARD را ادعا کند، متن درون کلیپ‌بورد کپی می‌شود. هر زمان که یک کلاینت محتویات گزینش CLIPBOARD را درخواست کند، متن از کلیپ‌بورد کپی و دریافت می‌شود. نمونه‌هایی از پیوندهای رویداد (event bindings) که ممکن است کاربر مایل باشد برای استفاده از کلیپ‌بورد در یک فایل پیکربندی منبع قرار دهد عبارتند از:
*VT100.Translations: #override <Btn3Up>: select-end(CLIPBOARD) 0 <Btn2Up>: insert-selection(PRIMARY,CLIPBOARD) 0 <Btn2Down>: ignore ()
همچنین ببینید (SEE ALSO)
X(7), xcutsel(1), xterm(1)، مستندات اختصاصی هر کلاینت در مورد نحوهٔ ایجاد یک گزینش و ارسال آن به CLIPBOARD.
محیط (ENVIRONMENT)
- DISPLAY
- برای به دست آوردن نام میزبان و شمارهٔ نمایشگر پیش‌فرض.
- XENVIRONMENT
- برای دریافت نام فایل منبعی که اولویتی بالاتر از منابع سراسری ذخیره شده در ویژگی RESOURCE_MANAGER دارد.
فایل‌ها (FILES)
- /usr/share/X11/app-defaults/XClipboard
- منابع پیش‌فرض مورد نیاز برنامه را مشخص می‌کند.
نویسندگان (AUTHORS)
Ralph R. Swick, DEC/MIT Project Athena
Chris D. Peterson, MIT X Consortium
Keith Packard, MIT X Consortium
| 2025-03-23 | xclipboard 1.1.6 |