bionic (3) XmTextCut.3.gz

NAME

       XmTextCut  —  A Text function that copies the primary selection to the clipboard and deletes the selected
       text "XmTextCut" "Text functions" "XmTextCut"

SYNOPSIS

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

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

                                                                                                    XmTextCut(3)