XmTextCut(3X)

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

SYNOPSIS
     #include <Xm/Text.h>

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


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmTextCut copies the primary  selected  text  to  the  clipboard  and  then
     deletes the primary selected text.  This routine calls the widget's XmNval-
     ueChangedCallback  and  verification callbacks, either XmNmodifyVerifyCall-
     back 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 XmNmodifyVerify-
     CallbackWcs callbacks.

     widget Specifies the Text widget ID.

     time   Specifies the server time at which the selection value is to be mod-
            ified.   This  should  be the time of the event which triggered this
            request.  One source of a valid time stamp is the  function  XtLast-
            TimestampProcessed().


     For  a  complete  definition  of Text and its associated resources, see Xm-
     Text(3X).

RETURN VALUE
     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.

RELATED INFORMATION
     XmText(3X).

                                                                   XmTextCut(3X)