Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmTextCut(3)		    Library Functions Manual		    XmTextCut(3)

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

     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 suc-
     cessful, 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  Xm-
     Text(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 own-
     ership of the clipboard selection, or if no data is  placed  on  the  clip-
     board.  Otherwise, it returns True.

RELATED
     XmText(3).

								    XmTextCut(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmTextCut&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help