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

FreeBSD Manual Pages


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

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

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

       XmTextCut copies	the primary selected text to the  clipboard  and  then
       deletes the primary selected text.  This	routine	calls the widget's Xm-
       NvalueChangedCallback and verification callbacks, either	XmNmodifyVeri-
       fyCallback or XmNmodifyVerifyCallbackWcs, or both. If both verification
       callback	lists are registered, the procedures of	 the  XmNmodifyVerify-
       Callback	 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 trig-
		 gered 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-

       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.




Want to link to this manual page? Use this URL:

home | help