XmTextFieldCopyLink(3X)



     XmTextFieldCopyLink(3X)   UNIX System V   XmTextFieldCopyLink(3X)



     NAME
          XmTextFieldCopyLink - A TextField function that copies a
          link to the primary selection to the clipboard

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

     VERSION
          This page documents Motif 2.1.

     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).












     Page 1                                          (printed 1/22/99)
Museum
