NAME

       XmTextCopyLink  —  A  Text  function  that  copies  a  link  to  the  primary  selection to the clipboard
       "XmTextCopyLink" "Text functions" "XmTextCopyLink"

SYNOPSIS

       #include <Xm/Text.h>
       Boolean XmTextCopyLink(
       Widget widget,
       Time time);

DESCRIPTION

       XmTextCopyLink copies a link to the primary selected text to  the  clipboard.   This  routine  calls  the
       XmNconvertCallback   procedures,   possibly   multiple   times,   with   the   selection  member  of  the
       XmConvertCallbackStruct set to CLIPBOARD and with the parm member set to XmLINK.  The Text widget  itself
       does  not  copy  any  links;  XmNconvertCallback  procedures  are responsible for copying the link to the
       clipboard and for taking any related actions.

       widget    Specifies the Text widget ID.

       time      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 XtLastTimestampProcessed.

       For a complete definition of Text and its associated resources, see XmText(3).

RETURN

       This  function  returns  False  if  the primary selection is NULL, if the widget 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.

RELATED

       XmText(3).

                                                                                               XmTextCopyLink(3)