xclipboard
X clipboard client
see also :
X - xcutsel - xterm
Synopsis
xclipboard
[ -toolkitoption ... ] [ -w ] [
-nw ]
add an example, a script, a trick and tips
examples
no example yet ...
... Feel free to add your own example above to help other Linux-lovers !
description
The
xclipboard program is used to collect and display
text selections that are sent to the CLIPBOARD by other
clients. It is typically used to save CLIPBOARD selections
for later use. It stores each CLIPBOARD selection as a
separate string, each of which can be selected. Each time
CLIPBOARD is asserted by another application,
xclipboard transfers the contents of that selection
to a new buffer and displays it in the text window. Buffers
are never automatically deleted, so you’ll want to use
the delete button to get rid of useless items.
Since
xclipboard uses a Text Widget to display the contents
of the clipboard, text sent to the CLIPBOARD may be
re-selected for use in other applications. xclipboard
also responds to requests for the CLIPBOARD selection from
other clients by sending the entire contents of the
currently displayed buffer.
An
xclipboard window has the following buttons across
the top:
quit
When this button is pressed, xclipboard
exits.
delete
When this button is pressed, the current buffer is
deleted and the next one displayed.
new
Creates a new buffer with no contents. Useful in
constructing a new CLIPBOARD selection by hand.
save
Displays a File Save dialog box. Pressing the Accept
button saves the currently displayed buffer to the file
specified in the text field.
next
Displays the next buffer in the list.
previous
Displays the previous
buffer.
options
The
xclipboard program accepts all of the standard X
Toolkit command line options as well as the following:
-w
This option indicates that lines of text that are too
long to be displayed on one line in the clipboard should
wrap around to the following lines.
-nw
This option indicates that long lines of text should not
wrap around. This is the default behavior.
display
to get the default host and display number.
XENVIRONMENT
to get the name of a resource file that overrides the global
resources stored in the RESOURCE_MANAGER property.
environment
files
/etc/X11/app-defaults/XClipboard
specifies required resources
sending
sending retrieving clipboard contents
Text is copied to the clipboard whenever a client asserts
ownership of the CLIPBOARD selection. Text is copied from
the clipboard whenever a client requests the contents of the
CLIPBOARD selection. Examples of event bindings that a
user may wish to include in a resource configuration file to use
the clipboard are:
*VT100.Translations: #override \
<Btn3Up>:
select-end(CLIPBOARD) \n\
<Btn2Up>:
insert-selection(PRIMARY,CLIPBOARD) \n\
<Btn2Down>:
ignore ()
widgets
In order to specify resources, it is useful to know the hierarchy
of the widgets which compose xclipboard. In the notation
below, indentation indicates hierarchical structure. The widget
class name is given first, followed by the widget instance name.
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
see also
X ,
xcutsel , xterm , individual client documentation for
how to make a selection and send it to the CLIPBOARD.
author
Ralph R. Swick,
DEC/MIT Project Athena
Chris D. Peterson, MIT X Consortium
Keith Packard, MIT X Consortium