XmTextCut(3X)

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

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

     VERSION
          This page documents Motif 2.1.

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

          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 XmMOVE.  If the transfer is successful, this
          routine then calls the XmNconvertCallback procedures for the
          CLIPBOARD selection and the DELETE target.

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