NAME

       XmTextFieldCopyLink  — A TextField function that copies a link to the primary selection to
       the clipboard "XmTextFieldCopyLink" "TextField functions" "XmTextFieldCopyLink"

SYNOPSIS

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

DESCRIPTION

       XmTextFieldCopyLink 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 TextField 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 TextField 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 TextField and its associated resources, see XmTextField(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

       XmTextField(3).

                                                                           XmTextFieldCopyLink(3)