'\" t
...\" TxtCopyL.sgm /main/7 1996/08/30 16:21:30 rws $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl			\" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl			\" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
.TH "XmTextCopyLink" "library call"
.SH "NAME"
\fBXmTextCopyLink\fP \(em A Text function that copies a link to the primary selection to the clipboard
.iX "XmTextCopyLink"
.iX "Text functions" "XmTextCopyLink"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/Text\&.h>
\fBBoolean \fBXmTextCopyLink\fP\fR(
\fBWidget \fBwidget\fR\fR,
\fBTime \fBtime\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmTextCopyLink\fP copies a link to the primary selected text to the
clipboard\&.
This routine calls the \fBXmNconvertCallback\fP procedures, possibly
multiple times, with the \fIselection\fP member of the
\fBXmConvertCallbackStruct\fR set to \fBCLIPBOARD\fP and with the
\fIparm\fP member set to \fBXmLINK\fP\&.
The Text widget itself does not copy any links; \fBXmNconvertCallback\fP
procedures are responsible for copying the link to the clipboard and for
taking any related actions\&.
.IP "\fIwidget\fP" 10
Specifies the Text widget ID\&.
.IP "\fItime\fP" 10
Specifies the time of the transfer\&.
This should be the time of the event which triggered this request\&.
One source of a valid time stamp is the function
\fBXtLastTimestampProcessed\fP\&.
.PP
For a complete definition of Text and its associated resources, see
\fBXmText\fP(3)\&.
.SH "RETURN"
.PP
This function returns False if the primary selection is NULL, if the
\fIwidget\fP does not own the primary selection, if the function is
unable to gain ownership of the clipboard selection, or if no data is
placed on the clipboard\&.
Otherwise, it returns True\&.
.SH "RELATED"
.PP
\fBXmText\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:33