NAME

       XmTextCopy  —  A  Text  function  that  copies  the primary selection to the clipboard "XmTextCopy" "Text
       functions" "XmTextCopy"

SYNOPSIS

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

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

                                                                                                   XmTextCopy(3)