XmTextFieldCut(3X)

NAME
     XmTextFieldCut  --A TextField function that copies the primary selection to
     the clipboard and deletes the selected text

SYNOPSIS
     #include <Xm/TextF.h>

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


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmTextFieldCut 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 TextField widget ID.

     time   Specifies  the  time at which the selection value is to be modified.
            This should be the time of the event which triggered this request.


     For a complete definition of TextField and its  associated  resources,  see
     XmTextField(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
     XmTextField(3X).

                                                              XmTextFieldCut(3X)