.\" Copyright 1988, 1994, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from The Open Group.
.\"
.\"
.TH XCLIPBOARD 1 2025-03-23 "xclipboard 1.1.6" "X Version 11"
.SH "نام (NAME)"
xclipboard \- کلاینت کلیپ‌بورد برای سامانهٔ پنجره‌ای X
.SH "خلاصه دستور (SYNOPSIS)"
\fBxclipboard\fP [ \fI\-toolkitoption\fP ... ] [ \fB\-w\fP ]
[ \fB\-nw\fP ]
.LP
\fBxclipboard\fP \fB\-help\fP | \fB\-version\fP
.SH "توضیحات (DESCRIPTION)"
برنامهٔ \fBxclipboard\fP برای جمع‌آوری و نمایش گزینش‌های متنی (text selections) که توسط سایر کلاینت‌ها به CLIPBOARD فرستاده می‌شوند، به کار می‌رود.
این برنامه معمولاً برای ذخیره کردن گزینش‌های CLIPBOARD جهت استفاده‌های بعدی کاربرد دارد.
برنامه هر گزینش CLIPBOARD را به صورت یک رشتهٔ مجزا ذخیره می‌کند که هر کدام از آن‌ها قابل انتخاب هستند.
هر بار که CLIPBOARD توسط برنامهٔ دیگری ادعا (assert) شود،
\fBxclipboard\fP محتویات آن گزینش را به یک بافر جدید منتقل کرده و آن را در پنجرهٔ متنی نمایش می‌دهد.
بافرها هیچ‌گاه به صورت خودکار حذف نمی‌شوند، بنابراین برای رهایی از موارد بلااستفاده باید از دکمهٔ delete استفاده کنید.
.PP
از آنجا که \fBxclipboard\fP برای نمایش محتویات کلیپ‌بورد از یک ویجت متنی (Text Widget) استفاده می‌کند، متنی که به CLIPBOARD ارسال شده است را می‌توان مجدداً برای استفاده در برنامه‌های دیگر گزینش کرد.
\fBxclipboard\fP همچنین به درخواست‌های دریافت گزینش CLIPBOARD از سوی دیگر کلاینت‌ها، با ارسال تمام محتویات بافری که در حال حاضر نمایش داده می‌شود، پاسخ می‌دهد.
.PP
پنجرهٔ \fBxclipboard\fP دکمه‌های زیر را در امتداد لبهٔ بالایی خود دارد:
.TP 8
.I quit
با فشردن این دکمه، \fBxclipboard\fP خارج می‌شود.
.TP 8
.I delete
با فشردن این دکمه، بافر فعلی حذف شده و بافر بعدی نمایش داده می‌شود.
.TP 8
.I new
یک بافر جدید بدون محتوا ایجاد می‌کند.
برای ایجاد دستی یک گزینشِ جدیدِ CLIPBOARD مفید است.
.TP 8
.I save
یک کادر محاوره‌ای ذخیرهٔ فایل (File Save) را نمایش می‌دهد.
فشردن دکمهٔ Accept بافر در حال نمایش را در فایلی که در فیلد متنی مشخص شده، ذخیره می‌کند.
.TP 8
.I next
بافر بعدی در فهرست را نمایش می‌دهد.
.TP 8
.I previous
بافر قبلی را نمایش می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
برنامهٔ \fBxclipboard\fP تمامی گزینه‌های خط فرمان استاندارد X Toolkit و همچنین موارد زیر را می‌پذیرد:
.TP 8
.B \-w
این گزینه مشخص می‌کند خطوط متنی که بیش از حد برای نمایش در یک خط کلیپ‌بورد طولانی هستند، باید شکسته شده و به خطوط بعدی منتقل شوند (wrap).
.TP 8
.B \-nw
این گزینه مشخص می‌کند خطوط طولانی متن نباید شکسته شوند.
این رفتار پیش‌فرض است.
.TP 8
.B \-help
پیام راهنمای نحوهٔ استفاده را چاپ کرده و خارج می‌شود.
.TP 8
.B \-version
اطلاعات نسخه را چاپ کرده و خارج می‌شود.
.SH "ویجت‌ها (WIDGETS)"
به منظور مشخص کردن منابع (resources)، دانستن سلسله‌مراتب ویجت‌هایی که \fBxclipboard\fR را تشکیل می‌دهند مفید است.
در ساختار زیر، تورفتگی نشان‌دهندهٔ ساختار سلسله‌مراتبی است.
ابتدا نام کلاس ویجت و سپس نام نمونهٔ (instance) ویجت ذکر شده است.
.sp
.nf
.ft CW
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
.ft
.fi
.sp
.SH "ارسال/دریافت محتویات کلیپ‌بورد (SENDING/RETRIEVING CLIPBOARD CONTENTS)"
هر زمان که یک کلاینت مالکیت گزینش \fBCLIPBOARD\fP را ادعا کند، متن درون کلیپ‌بورد کپی می‌شود.
هر زمان که یک کلاینت محتویات گزینش \fBCLIPBOARD\fP را درخواست کند، متن از کلیپ‌بورد کپی و دریافت می‌شود.
نمونه‌هایی از پیوندهای رویداد (event bindings) که ممکن است کاربر مایل باشد برای استفاده از کلیپ‌بورد در یک فایل پیکربندی منبع قرار دهد عبارتند از:
.sp
.nf
.ft CW
*VT100.Translations: #override \
        <Btn3Up>:       select-end(CLIPBOARD) \n\
        <Btn2Up>:       insert-selection(PRIMARY,CLIPBOARD) \n\
        <Btn2Down>:     ignore ()
.ft
.fi
.sp
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7),
.BR xcutsel (1),
.BR xterm (1)،
مستندات اختصاصی هر کلاینت در مورد نحوهٔ ایجاد یک گزینش و ارسال آن به \fBCLIPBOARD\fP.
.SH "محیط (ENVIRONMENT)"
.TP 8
.B DISPLAY
برای به دست آوردن نام میزبان و شمارهٔ نمایشگر پیش‌فرض.
.TP 8
.B XENVIRONMENT
برای دریافت نام فایل منبعی که اولویتی بالاتر از منابع سراسری ذخیره شده در ویژگی RESOURCE_MANAGER دارد.
.SH "فایل‌ها (FILES)"
.TP
.I /usr/share/X11/app-defaults/XClipboard
منابع پیش‌فرض مورد نیاز برنامه را مشخص می‌کند.
.SH "نویسندگان (AUTHORS)"
Ralph R. Swick, DEC/MIT Project Athena
.br
Chris D. Peterson, MIT X Consortium
.br
Keith Packard, MIT X Consortium