NAME    [Toc]    [Back]

       XmTextCut - A Text function that copies the primary selection
 to the clipboard and deletes the selected text

SYNOPSIS    [Toc]    [Back]

       #include <Xm/Text.h>

       Boolean XmTextCut (widget, time)
               Widget widget;
               Time time;

DESCRIPTION    [Toc]    [Back]

       XmTextCut copies the primary selected text  to  the  clipboard
  and  then  deletes  the primary selected text. This
       routine calls  the  widget's  XmNvalueChangedCallback  and
       verification  callbacks, either XmNmodifyVerifyCallback or
       XmNmodifyVerifyCallbackWcs, or both.  If both verification
       callback  lists are registered, the procedures of the XmNmodifyVerifyCallback
  list  are  executed  first  and  the
       resulting data is passed to the XmNmodifyVerifyCallbackWcs
       callbacks.  Specifies the Text widget ID.   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(3X).

RETURN VALUE    [Toc]    [Back]

       This  function  returns  False if the primary selection is
       NULL, if the widget doesn't own the primary selection,  or
       if  the  function is unable to gain ownership of the clipboard
 selection. Otherwise, it returns True.

SEE ALSO    [Toc]    [Back]

       XmText(3X)



                                                    XmTextCut(3X)