XmTextCopy(3X)

     NAME
          XmTextCopy - A Text function that copies the primary
          selection to the clipboard

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

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmTextCopy copies 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 XmCOPY.

          widget    Specifies the Text widget ID.

          time      Specifies the server time at which the selection
                    value is to be modified. 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).